Curios

Curios Customers API

The Customers API from Curios — 3 operation(s) for customers.

GitHub OpenAPI

Operations 4

POST /customers POST /customers #
POST /customers/ Update the customer profile details #
GET /customers/{customerid} GET /customers/collections #
POST /customers/{customerid} POST /customers/login #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/curios/openapi/curios-customers-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/curios/json-schema/curios-post-customers-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/curios/json-schema/curios-post-customers-customerid-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/curios/json-schema/curios-post-orders-orderid-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/curios:curios-customers-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

curios-customers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Curios Customers API
  version: '2026-10-12'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-12: 18 operation(s) read from 9 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Curios has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 44
    documentation: -26
    pages-with-code: 9
    pages-read: 9
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-12'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://content.curios.com/docs/customers
  - https://content.curios.com/docs/collections
  - https://content.curios.com/docs/listings
  - https://content.curios.com/docs/orders
  - https://content.curios.com/docs/contracts
  - https://content.curios.com/docs/projects
  - https://content.curios.com/docs/admin-contracts
  - https://content.curios.com/docs/admin-collections
  - https://content.curios.com/docs/admin-tokens
servers:
- url: https://marketplace-api.curios.com
security:
- apiKey: []
tags:
- name: Customers
paths:
  /customers:
    post:
      operationId: post_customers
      tags:
      - Customers
      summary: POST /customers
      x-source: https://content.curios.com/docs/customers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST ' https://marketplace-api.curios.com/customers/ '  -H 'Content-type: application/json'\n-H ' curios-api-key: {API Key} '\n-H ' curios-date: {UTC Date/Time Stamp} '\n-H ' Authorization: Bearer {JWT} '  -d '{\n \" first_name \": \" {first_name} \", \n \" last_name \": \" {last_name} \", \n \" display_name \": \" {display_name} \", \n \" email \": \" {email} \", \n \" phone \": \" {phone} \", \n \" is_subscribed \": {"
  /customers/:
    post:
      operationId: postCustomers
      tags:
      - Customers
      summary: Update the customer profile details
      x-source: https://content.curios.com/docs/customers
      parameters:
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer {JWT} The JWT session token issued upon succesful customer login and verification.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCustomersRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
      x-operation-id-source: normalized
      x-operation-id-original: post_customers
  /customers/{customerid}:
    get:
      operationId: get_customers_customerid
      tags:
      - Customers
      summary: GET /customers/collections
      x-source: https://content.curios.com/docs/customers
      parameters:
      - name: customerid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET ' https://marketplace-api.curios.com/customers/collections '  -H 'Content-type: application/json'\n-H ' curios-api-key: {API Key} '\n-H ' curios-date: {UTC Date/Time Stamp} '\n-H ' Authorization: Bearer {JWT} '  Collection Tokens   \n Login To Try It Out \n   /customers/collections/:id/tokens (GET) \n Collection-specific tokens owned by a customer. \n Authorization \n Header \n Value \n Descript"
        collapsed_from: 5 example path(s) differing only at customerId
    post:
      operationId: post_customers_customerid
      tags:
      - Customers
      summary: POST /customers/login
      x-source: https://content.curios.com/docs/customers
      parameters:
      - name: customerid
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCustomersCustomeridRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST ' https://marketplace-api.curios.com/customers/login '  -H 'Content-type: application/json'\n-H ' curios-api-key: {API Key} '\n-H ' curios-date: {UTC Date/Time Stamp} '\n-d '{\n \" email \": \" {email} \", \n \" password \": \" {password} \"\n}' \n Login Verify   \n Login To Try It Out \n   /customers/verify (POST) \n Verify two-factor code for a customer login. \n Body \n Argument \n Value \n Required \n D"
        collapsed_from: 7 example path(s) differing only at customerId
components:
  schemas:
    PostCustomersCustomeridRequest:
      type: object
      properties:
        ' email ':
          type: string
        ' password ':
          type: string
    PostCustomersRequest:
      type: object
      properties:
        first_name:
          type: string
          description: First name of the customer/user.
        last_name:
          type: string
          description: Last name of the customer/user.
        display_name:
          type: string
          description: display_name
        email:
          type: string
          description: email
        phone:
          type: string
          description: phone
        is_subscribed:
          type: boolean
          description: is_subscribed
        is_whitelisted:
          type: boolean
          description: is_whitelisted
        avatar:
          type: string
          description: avatar
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: curios-api-key