> ## Documentation Index
> Fetch the complete documentation index at: https://syncupai-claude-update-docs-terminology-g7r40.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a US KYB report request



## OpenAPI

````yaml /openapi-kyb.json post /v1/us-kyb/reports
openapi: 3.1.0
info:
  title: Reprompt US KYB API
  description: >-
    Create and poll authenticated US KYB report requests. Completed responses
    include the full report payload and a direct S3 PDF URL.
  version: 1.0.0
servers:
  - url: https://api.reprompt.io
security:
  - bearerAuth: []
paths:
  /v1/us-kyb/reports:
    post:
      summary: Create a US KYB report request
      operationId: create_us_kyb_report_v1_us_kyb_reports_post
      parameters:
        - name: org_slug
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Org Slug
        - name: apiKey
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Apikey
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UsKybCreateRequest'
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UsKybCreateResponse'
        '401':
          description: Missing or invalid authentication.
        '402':
          description: US KYB is not available for this country.
        '422':
          description: Missing required business or address fields.
        '502':
          description: Upstream provider error.
      security:
        - HTTPBearer: []
components:
  schemas:
    UsKybCreateRequest:
      properties:
        business_name:
          type: string
          minLength: 1
          title: Business Name
        submitted_by_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Submitted By Name
        address:
          $ref: '#/components/schemas/UsKybAddressRequest'
        tin:
          anyOf:
            - $ref: '#/components/schemas/UsKybTinRequest'
            - type: 'null'
        stream:
          type: boolean
          title: Stream
          default: false
      additionalProperties: false
      type: object
      required:
        - business_name
        - address
      title: UsKybCreateRequest
    UsKybCreateResponse:
      properties:
        request_id:
          type: string
          title: Request Id
        status:
          type: string
          const: processing
          title: Status
          default: processing
        poll_url:
          type: string
          title: Poll Url
        stream:
          anyOf:
            - $ref: '#/components/schemas/UsKybStreamMetadata'
            - type: 'null'
      type: object
      required:
        - request_id
        - poll_url
      title: UsKybCreateResponse
    UsKybAddressRequest:
      properties:
        address_line1:
          type: string
          minLength: 1
          title: Address Line1
        city:
          type: string
          minLength: 1
          title: City
        state:
          type: string
          minLength: 1
          title: State
        postal_code:
          type: string
          minLength: 1
          title: Postal Code
        country_code:
          type: string
          minLength: 1
          title: Country Code
      additionalProperties: false
      type: object
      required:
        - address_line1
        - city
        - state
        - postal_code
        - country_code
      title: UsKybAddressRequest
    UsKybTinRequest:
      properties:
        number:
          anyOf:
            - type: string
            - type: 'null'
          title: Number
      additionalProperties: false
      type: object
      title: UsKybTinRequest
    UsKybStreamMetadata:
      properties:
        stream_id:
          type: string
          title: Stream Id
        channel:
          type: string
          title: Channel
        event_name:
          type: string
          title: Event Name
          default: kyb:stream:event
      type: object
      required:
        - stream_id
        - channel
      title: UsKybStreamMetadata
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
    HTTPBearer:
      type: http
      scheme: bearer

````