_done directory submission API

openapi: 3.2.0
info:
  title: Lite directory submission API
  description: Places an order to have a website submitted to twenty directories that publish a link back to it, and returns a confirmation number so the order can be checked later for free.
  version: 1.0.0
  contact:
    name: _done
    url: https://forms.gle/5KzuSFH7p8hHtDmz7
    email: info@underscoredone.com
  x-openapi-url: https://directory-submission-lite.underscoredone.com/openapi.json
  x-logo:
    url: https://underscoredone.com/logo.png
    altText: _done
  x-guidance: Call this once per website to order directory submissions. Save the submissionid from the reply — it cannot be recovered and it is the only way to retrieve the order. Do not call this again to check progress; that would place a second paid order. To check progress, send the confirmation number to the /status address on this same service, which is free.
  x-ai-instructions: Call this once per website to order directory submissions. Save the submissionid from the reply — it cannot be recovered and it is the only way to retrieve the order. Do not call this again to check progress; that would place a second paid order. To check progress, send the confirmation number to the /status address on this same service, which is free.
  x-provider: _done — single-purpose utility APIs for developers and AI agents. Pay per call with USDC on Base Mainnet or Solana Mainnet.
  x-pricing:
    model: pay-per-call
    currency: USDC
    network: Base Mainnet or Solana Mainnet
    price: $10.00
  x-keywords:
  - network
  - directory submission
  - backlinks
  - seo
  - indexing
  - link building
  - new website
  - search engine discovery
  - site submission
  - order
  - utility
  - api
  - ai-agent
  - pay-per-call
  - usdc
  - x402
  x-category: directory submission
  x-provider-url: https://underscoredone.com
  x-agentcash-auth:
    mode: paid
  x-402:
    price: $10.00
    network: eip155:8453
    asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
    pay_to: '0xE9740820225B3918b4ddd1292C7cA4Ca0e2C2F08'
    facilitator: https://api.cdp.coinbase.com/platform/v2/x402
    scheme: exact
    description: Places an order to have a website submitted to twenty directories that publish a link back to it, and returns a confirmation number so the order can be checked later for free.
    mime_type: application/json
    networks:
    - network: eip155:8453
      asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
      pay_to: '0xE9740820225B3918b4ddd1292C7cA4Ca0e2C2F08'
    - network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
      asset: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
      pay_to: 8ugAWAXDB8V18kiUrGZTq1oMvU3C6Fxs8hfC6rvzQT3b
servers:
- url: https://directory-submission-lite.underscoredone.com
  description: Production
tags:
- name: directory submission
paths:
  /submit:
    post:
      tags:
      - directory submission
      summary: Orders submission of a website to twenty directories and returns a confirmation number.
      description: Place an order to submit a website address to twenty directories and get back a confirmation number to track it later.
      operationId: handler_submit_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Request'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response'
              examples:
                success:
                  summary: Successful response
                  value:
                    api_version: 1.0.0
        '422':
          description: Unprocessable — a required field is missing or the wrong type. Check the detail field for specifics.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
        '402':
          description: Payment required. Send a signed USDC payment on Base Mainnet or Solana Mainnet using the x402 protocol.
          headers:
            X-Payment-Response:
              description: x402 payment challenge — base64-encoded JSON with payment details.
              schema:
                type: string
        '400':
          description: Bad request — your input failed validation or could not be processed. Check the detail field for specifics.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
      x-ai-instructions: Call this once per website to order directory submissions. Save the submissionid from the reply — it cannot be recovered and it is the only way to retrieve the order. Do not call this again to check progress; that would place a second paid order. To check progress, send the confirmation number to the /status address on this same service, which is free.
      x-guidance: Call this once per website to order directory submissions. Save the submissionid from the reply — it cannot be recovered and it is the only way to retrieve the order. Do not call this again to check progress; that would place a second paid order. To check progress, send the confirmation number to the /status address on this same service, which is free.
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '10.00'
        protocols:
        - x402: {}
  /status:
    post:
      tags:
      - directory submission
      summary: Orders submission of a website to twenty directories and returns a confirmation number.
      description: Check on an existing order using its confirmation number. Free and unlimited.
      operationId: status_handler_status_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StatusRequest'
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
              examples:
                success:
                  summary: Successful response
                  value:
                    api_version: 1.0.0
        '422':
          description: Unprocessable — a required field is missing or the wrong type. Check the detail field for specifics.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: array
        '402':
          description: Payment required. Send a signed USDC payment on Base Mainnet or Solana Mainnet using the x402 protocol.
          headers:
            X-Payment-Response:
              description: x402 payment challenge — base64-encoded JSON with payment details.
              schema:
                type: string
        '400':
          description: Bad request — your input failed validation or could not be processed. Check the detail field for specifics.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
      x-ai-instructions: Call this once per website to order directory submissions. Save the submissionid from the reply — it cannot be recovered and it is the only way to retrieve the order. Do not call this again to check progress; that would place a second paid order. To check progress, send the confirmation number to the /status address on this same service, which is free.
      x-guidance: Call this once per website to order directory submissions. Save the submissionid from the reply — it cannot be recovered and it is the only way to retrieve the order. Do not call this again to check progress; that would place a second paid order. To check progress, send the confirmation number to the /status address on this same service, which is free.
      x-payment-info:
        price:
          fixed:
            mode: fixed
            currency: USD
            amount: '10.00'
        protocols:
        - x402: {}
components:
  schemas:
    StatusData:
      properties:
        submissionid:
          type: string
          title: Submissionid
          description: The confirmation number for this order
        url:
          type: string
          title: Url
          description: The web address that was submitted
        status:
          type: string
          title: Status
          description: The current stage of the order
        created_at:
          type: string
          title: Created At
          description: The moment the order was placed, in universal time
        notes:
          type: string
          title: Notes
          description: Any note attached to the order
          default: ''
        submitted_urls:
          items:
            type: string
          type: array
          title: Submitted Urls
          description: The directory addresses where the site has been published so far
      type: object
      required:
      - submissionid
      - url
      - status
      - created_at
      title: StatusData
      example:
        created_at: '2026-07-28T00:00:00.000Z'
        notes: ''
        status: received
        submissionid: 3f2b1c4a-1234-4a1b-8c1d-abcdefabcdef
        submitted_urls: []
        url: https://example.com
    Response:
      properties:
        api_version:
          type: string
          title: Api Version
          description: The version of this service that answered
          default: 1.0.0
        data:
          $ref: '#/components/schemas/OrderData'
          description: The details of the order that was placed
      type: object
      required:
      - data
      title: Response
      example:
        api_version: 1.0.0
        data:
          created_at: '2026-07-28T00:00:00.000Z'
          message: Order received and queued for submission.
          ok: true
          status: received
          status_url: https://directory-submission-lite.underscoredone.com/status
          submissionid: 3f2b1c4a-1234-4a1b-8c1d-abcdefabcdef
          url: https://example.com
    StatusRequest:
      properties:
        submissionid:
          type: string
          title: Submissionid
          description: The confirmation number returned when the order was placed
      type: object
      required:
      - submissionid
      title: StatusRequest
      example:
        submissionid: 3f2b1c4a-1234-4a1b-8c1d-abcdefabcdef
    StatusResponse:
      properties:
        api_version:
          type: string
          title: Api Version
          description: The version of this service that answered
          default: 1.0.0
        data:
          $ref: '#/components/schemas/StatusData'
          description: The current state of the order
      type: object
      required:
      - data
      title: StatusResponse
      example:
        api_version: 1.0.0
        data:
          created_at: '2026-07-28T00:00:00.000Z'
          notes: ''
          status: received
          submissionid: 3f2b1c4a-1234-4a1b-8c1d-abcdefabcdef
          submitted_urls: []
          url: https://example.com
    OrderData:
      properties:
        ok:
          type: boolean
          title: Ok
          description: Whether the order was recorded successfully
        submissionid:
          type: string
          title: Submissionid
          description: The confirmation number for this order; keep it safe, it cannot be recovered later
        url:
          type: string
          title: Url
          description: The web address that was submitted
        status:
          type: string
          title: Status
          description: The current stage of the order
        created_at:
          type: string
          title: Created At
          description: The exact moment the order was placed, in universal time
        status_url:
          type: string
          title: Status Url
          description: The address to send the confirmation number to when checking on the order later, for free
        message:
          type: string
          title: Message
          description: A short plain English note about what happens next
      type: object
      required:
      - ok
      - submissionid
      - url
      - status
      - created_at
      - status_url
      - message
      title: OrderData
      example:
        created_at: '2026-07-28T00:00:00.000Z'
        message: Order received and queued for submission.
        ok: true
        status: received
        status_url: https://directory-submission-lite.underscoredone.com/status
        submissionid: 3f2b1c4a-1234-4a1b-8c1d-abcdefabcdef
        url: https://example.com
    Request:
      properties:
        url:
          type: string
          title: Url
          description: The full web address of the site to submit, including the leading https://, for example https://example.com
      type: object
      required:
      - url
      title: Request
      example:
        url: https://example.com
  securitySchemes:
    siwx:
      type: apiKey
      in: header
      name: SIGN-IN-WITH-X
      description: CAIP-122 wallet signature for repeat access after payment
x-payment-accepts:
- scheme: exact
  network: eip155:8453
  payTo: '0xE9740820225B3918b4ddd1292C7cA4Ca0e2C2F08'
  asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
- scheme: exact
  network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
  payTo: 8ugAWAXDB8V18kiUrGZTq1oMvU3C6Fxs8hfC6rvzQT3b
  asset: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v