openapi: 3.1.0
info:
  title: Curios 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
paths:
  /collections:
    get:
      operationId: get_collections
      tags:
      - Collections
      summary: GET /collections
      x-source: https://content.curios.com/docs/collections
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET ' https://marketplace-api.curios.com/collections/ '  -H 'Content-type: application/json'\n-H ' curios-api-key: {API\
          \ Key} '\n-H ' curios-date: {UTC Date/Time Stamp} '\n Collection Details   \n Login To Try It Out \n   /collections/:id (GET) \n Details\
          \ of an NFT collection. "
  /collections/:
    get:
      operationId: get_collections
      tags:
      - Collections
      summary: List all NFT collections.
      description: Public endpoint to list all NFT collections.
      x-source: https://content.curios.com/docs/collections
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /contracts:
    get:
      operationId: get_contracts
      tags:
      - Contracts
      summary: GET /contracts
      x-source: https://content.curios.com/docs/contracts
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET ' https://marketplace-api.curios.com/contracts/ '  -H 'Content-type: application/json'\n-H ' curios-api-key: {API\
          \ Key} '\n-H ' curios-date: {UTC Date/Time Stamp} '\n Load   \n Login To Try It Out \n   /contracts/load (GET) \n Load smart contract\
          \ details, including deployment status. \n Authorization \n Header \n Value \n Description \n Authorization \n Bearer {JWT} \n The JWT\
          \ session token issued u"
  /contracts/:
    get:
      operationId: get_contracts
      tags:
      - Contracts
      summary: Contracts
      x-source: https://content.curios.com/docs/contracts
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /contracts/{contractid}:
    post:
      operationId: post_contracts_contractid
      tags:
      - Contracts
      summary: POST /contracts/approve
      x-source: https://content.curios.com/docs/contracts
      parameters:
      - name: contractid
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST ' https://marketplace-api.curios.com/contracts/approve '  -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 \" cost \": {cost} , \n \" currency\
          \ \": \" {currency code} \", \n \" approval_code \": \" {approval code} \", \n \" is_approved \": {true/false} \n}' \n Header Values\
          \ \n Body Arguments \n Cancel"
        collapsed_from: 3 example path(s) differing only at contractId
  /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: post_customers
      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
  /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
  /listings:
    get:
      operationId: get_listings
      tags:
      - Listings
      summary: GET /listings
      x-source: https://content.curios.com/docs/listings
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET ' https://marketplace-api.curios.com/listings/ '  -H 'Content-type: application/json'\n-H ' curios-api-key: {API\
          \ Key} '\n-H ' curios-date: {UTC Date/Time Stamp} '\n Listing Details   \n Login To Try It Out \n   /listings/:id (GET) "
  /listings/:
    get:
      operationId: get_listings
      tags:
      - Listings
      summary: Public endpoints for all tokens for sale in the primary and secondary marketplaces.
      description: Retrieve a list of all listings.
      x-source: https://content.curios.com/docs/listings
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /orders:
    get:
      operationId: get_orders
      tags:
      - Orders
      summary: GET /orders
      x-source: https://content.curios.com/docs/orders
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET ' https://marketplace-api.curios.com/orders/ '  -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} '  Order Details   \n Login To Try It Out \n   /orders/:id\
          \ (GET) \n Order details including checkout link if the order is in \"PENDING\" status. \n Authorization \n Header \n Value \n Description\
          \ \n Authori"
  /orders/:
    get:
      operationId: get_orders
      tags:
      - Orders
      summary: All orders for a customer.
      x-source: https://content.curios.com/docs/orders
      parameters:
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer {JWT} The JWT session token issued upon successful customer login and verification.
      - name: curios-api-key
        in: header
        required: true
        schema:
          type: string
        description: API Key
      - name: curios-date
        in: header
        required: true
        schema:
          type: string
        description: UTC Date/Time Stamp
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /orders/{orderid}:
    post:
      operationId: post_orders_orderid
      tags:
      - Orders
      summary: POST /orders/cartAddItem
      x-source: https://content.curios.com/docs/orders
      parameters:
      - name: orderid
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostOrdersOrderidRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST ' https://marketplace-api.curios.com/orders/cartAddItem '  -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 \" listing_id \": {listing id}\
          \ \n}' \n Cart Delete Item   \n Login To Try It Out \n   /orders/cartDeleteItem (POST) \n Deletes and item from the PENDING order/shopping\
          \ cart. \n Autho"
        collapsed_from: 3 example path(s) differing only at orderId
  /projects:
    get:
      operationId: get_projects
      tags:
      - Projects
      summary: GET /projects
      x-source: https://content.curios.com/docs/projects
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X GET ' https://marketplace-api.curios.com/projects/ '  -H 'Content-type: application/json'\n-H ' curios-api-key: {API\
          \ Key} '\n-H ' curios-date: {UTC Date/Time Stamp} '\n Load   \n Login To Try It Out \n   /projects/:id (GET) "
  /projects/:
    get:
      operationId: get_projects
      tags:
      - Projects
      summary: List
      description: Public endpoint to list all projects.
      x-source: https://content.curios.com/docs/projects
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /tokens/transfer:
    post:
      operationId: post_tokens_transfer
      tags:
      - Tokens
      summary: POST /tokens/transfer
      x-source: https://content.curios.com/docs/admin-tokens
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST ' https://marketplace-api.curios.com/tokens/transfer '  -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} '  Header Values \n Body Arguments \n Cancel\
          \ \n Run Code \n ← Back to Curios.com \n Support \n account_circle Discord \n chat Live Chat (coming soon) \n email [email protected]\
          \ \n Let's build toge"
  /tokens/{tokenid}:
    get:
      operationId: get_tokens_tokenid
      tags:
      - Tokens
      summary: GET /tokens/list
      x-source: https://content.curios.com/docs/admin-tokens
      parameters:
      - name: tokenid
        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/tokens/list '  -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} '  Load   \n Login To Try It Out \n   /tokens/load\
          \ (GET) \n Load token details. \n Authorization \n Header \n Value \n Description \n Authorization \n Bearer {JWT} \n The JWT session\
          \ token issued upon s"
        collapsed_from: 2 example path(s) differing only at tokenId
components:
  schemas:
    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
    PostCustomersCustomeridRequest:
      type: object
      properties:
        ' email ':
          type: string
        ' password ':
          type: string
    PostOrdersOrderidRequest:
      type: object
      properties:
        ' confirmation_redirect ':
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: curios-api-key
security:
- apiKey: []
tags:
- name: Collections
- name: Contracts
- name: Customers
- name: Listings
- name: Orders
- name: Projects
- name: Tokens