> ## Documentation Index
> Fetch the complete documentation index at: https://developer.meow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit representative KYC data

> Submit identity (KYC) data for a representative you added. Verification runs server-side; poll the entity onboarding status endpoint for the result. Use this when you hold the representative's identity details; otherwise mint a verification link for them to self-verify.



## OpenAPI

````yaml POST /entities/{entity_id}/representatives/{representative_id}/kyc
openapi: 3.1.0
info:
  title: Meow API
  description: >
    ## Overview


    The Meow API provides financial services and billing capabilities for your
    business.


    ### Core Features


    - **Financial data access**: access account information, transactions,
    balances, and payment networks.

    - **Crypto operations**: create and manage crypto contacts, and initiate
    USDC transfers across blockchain networks.

    - **Bill pay**: draft bills payable to your vendors and track them through
    payment.


    ### Bill Pay API


    The Bill Pay API lets you create bills for your vendors and track them
    through payment:


    - **Bill drafting**: create bills as drafts. Nothing is paid until someone
    approves the bill in the Meow dashboard.

    - **Attachments**: upload invoices and supporting documents to a bill.

    - **Bulk loads**: send an `Idempotency-Key` with every create so a retry
    never duplicates a bill. Drafting is capped at 500 bills per rolling 24
    hours per creator — your entity key, or the user a user-scoped key acts as.
    Creates past the cap return `429 Too Many Requests`.


    ### Billing API


    The Billing API lets you create and manage invoices and collect payments:


    - **Product management**: create and manage products with custom pricing.

    - **Customer management**: maintain invoicing customers with their
    addresses.

    - **Invoice creation**: generate invoices with line items, discounts, and
    custom notes.

    - **Payment options**: accept payments via ACH, wire, international wire,
    card, and USDC.

    - **Collection accounts**: configure accounts for payment collection.


    ### Getting Started


    Authenticate by sending your API key in the `x-api-key` request header.


    To scope requests to a specific entity, include the `x-entity-id` header.
    Use the `/api-keys/accessible-entities` endpoint to list all entities
    accessible by your API key.


    ### Rate Limits


    Each API key has a limit on requests per minute. The `RateLimit-Policy`
    header on every response shows your key's limit. The limit counts your
    requests in each clock minute, so you can spend the whole minute at once,
    and the count starts over when the minute ends.


    Responses carry the `RateLimit-Policy` and `RateLimit` headers. They show
    your limit, the requests you have left, and the seconds until the current
    minute ends.


    Meow is rolling out enforcement of this limit. Until it is enforced, going
    over the limit is logged, not rejected. Once it is, a request over the limit
    returns `429 Too Many Requests` with a `Retry-After` header, the headers
    above, and a body with `error_code` set to `rate_limited` and a `message`.


    A separate, coarser safeguard protects the API from abusive traffic and can
    also reject requests with `429`. Its response carries `Retry-After` and the
    same body, but not the quota headers.


    Whichever sends it, wait at least `Retry-After` seconds and add a small
    random delay. If the retry is limited again, back off exponentially. Send an
    `Idempotency-Key` when you retry a request that creates something or moves
    money.


    ### Error Responses


    Errors return JSON with `code`, `message`, and `debug_message`. The `code`
    aligns with FDX where possible; use `debug_message` for troubleshooting
    only.


    Common error codes:


    - `500`: Internal server error

    - `501`: Subsystem unavailable

    - `503`: Scheduled maintenance

    - `601`: Data not found

    - `602`: Customer not authorized

    - `701`: Account not found

    - `703`: Invalid input (including invalid date ranges)

    - `704`: Account type not supported

    - `705`: Account is closed

    - `801`: Transaction not found
  contact:
    name: Meow
    url: https://meow.com/
    email: support@meow.com
  version: 1.0.0
  license:
    name: Proprietary
    url: https://www.meow.com/terms-of-service
servers:
  - url: https://api.meow.com/v1
    description: Meow API Production
  - url: https://api.sandbox.meow.com/v1
    description: Meow API Sandbox
  - url: https://api.dev.meow.com/v1
    description: Meow API Development
security:
  - apiKeyAuth: []
tags:
  - name: API Keys
    description: Retrieve metadata about API keys and their accessible entities.
  - name: Accounts
    description: Access and manage accounts.
  - name: Approvals
  - name: Balances
    description: Retrieve account balances and available funds.
  - name: Bill Pay
  - name: Bills
    description: View and manage bills for vendor payments.
  - name: Cards
    description: Manage virtual and physical cards, and view transactions and insights.
  - name: Collection Accounts
    description: Manage accounts for payment collection.
  - name: Contacts
    description: Manage contacts for crypto and USDC transfers.
  - name: Customers
    description: Manage invoicing customers and their details.
  - name: Entities
  - name: Feature Access
    description: >-
      Request access to restricted features, such as international payments, and
      track the status of your requests.
  - name: Invoices
    description: Create and manage invoices.
  - name: Limits
  - name: Line Items
    description: Manage invoice line items.
  - name: Partner Onboarding
    description: Onboard entities using your partner API key.
  - name: Partner Webhooks
  - name: Payment Methods
    description: View available payment method types.
  - name: Payment Networks
    description: Manage payment networks and routing information.
  - name: Products
    description: Manage products and pricing for invoicing.
  - name: Reimbursements
    description: View reimbursement requests by employee.
  - name: Routing Numbers
    description: Validate routing numbers and retrieve bank information.
  - name: Security Policies
  - name: Simulations
    description: >-
      Trigger simulated events (inbound transfers, card authorizations,
      application approval) to test integrations end-to-end without real money
      movement. **Not available in production**: these endpoints exist only in
      sandbox and development environments and return `404 Not Found` in
      production.
  - name: Tax Forms
    description: Retrieve IRS tax forms (1099 family) issued for accounts.
  - name: Transactions
    description: Retrieve account transaction history and details.
  - name: Transfers
    description: >-
      Initiate ACH, wire, book, and crypto transfers, and retrieve transfer
      details.
  - name: Users
    description: View active users for your entity.
  - name: Webhooks
    description: Manage webhook subscriptions and inspect delivery history.
  - name: Wire Drawdowns
    description: >-
      Review vendor requests to draw funds by wire, and pre-authorize trusted
      vendors.
paths:
  /entities/{entity_id}/representatives/{representative_id}/kyc:
    post:
      tags:
        - Entities
      summary: Submit Representative KYC Data
      description: >-
        Submit identity (KYC) data for a representative you added. Verification
        runs server-side; poll the entity onboarding status endpoint for the
        result. Use this when you hold the representative's identity details;
        otherwise mint a verification link for them to self-verify.
      operationId: >-
        submit_representative_kyc_data_entities__entity_id__representatives__representative_id__kyc_post
      parameters:
        - name: representative_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              The representative, as returned in `representatives` on `GET
              /entities/{entity_id}`.
            title: Representative Id
          description: >-
            The representative, as returned in `representatives` on `GET
            /entities/{entity_id}`.
        - name: entity_id
          in: path
          required: true
          schema:
            type: string
            description: The entity being onboarded.
            title: Entity Id
          description: The entity being onboarded.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OnboardingKycIdentity'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityRepresentativeKycResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - apiKeyAuth:
            - entity:create
components:
  schemas:
    OnboardingKycIdentity:
      properties:
        first_name:
          type: string
          minLength: 1
          title: First Name
          description: Legal first name.
          examples:
            - Felix
        last_name:
          type: string
          minLength: 1
          title: Last Name
          description: Legal last name.
          examples:
            - Whiskers
        date_of_birth:
          $ref: '#/components/schemas/DateString'
          description: Date of birth (`YYYY-MM-DD`).
        id_number:
          anyOf:
            - type: string
              format: password
              writeOnly: true
            - type: 'null'
          title: Id Number
          description: >-
            Government ID number matching `id_type`. For `us_ssn` use nine
            digits, with or without dashes (123-45-6789 or 123456789); for
            `us_ssn_last_4` use the last four digits; for non-US ID types
            provide the number as issued. Formatting characters are stripped
            before verification. Required when the representative's country
            issues an ID type we can verify, and must be omitted when it does
            not (e.g. the United Kingdom, which has no supported ID type).
          examples:
            - 123-45-6789
        id_type:
          $ref: '#/components/schemas/ExtPlaidIDNumberType'
          description: >-
            Type of government ID, which must belong to the country of the
            representative's `address`. Defaults to `us_ssn`; non-US
            representatives pass their country-specific type (e.g. `sg_nric`,
            `au_passport`, `ca_sin`). Ignored when the country has no supported
            ID type.
          default: us_ssn
        address:
          $ref: '#/components/schemas/OnboardingAddress'
          description: Residential address.
        phone_number:
          anyOf:
            - type: string
              pattern: ^\+[1-9]\d{1,14}$
            - type: 'null'
          title: Phone Number
          description: Phone number in E.164 format (e.g. +14155550123).
          examples:
            - '+14155550123'
        ip:
          type: string
          format: ipvanyaddress
          title: Ip
          description: >-
            IPv4 or IPv6 address of the end user submitting this verification.
            Forwarded to the identity-verification provider as a fraud signal.
          examples:
            - 203.0.113.42
      type: object
      required:
        - first_name
        - last_name
        - date_of_birth
        - address
        - ip
      title: OnboardingKycIdentity
    EntityRepresentativeKycResponse:
      properties:
        representative_id:
          type: string
          format: uuid
          title: Representative Id
          description: ID of the representative whose KYC was submitted.
        kyc_status:
          $ref: '#/components/schemas/OnboardingKycStatus'
          description: >-
            This representative's identity verification status right after
            submission. It completes asynchronously; track this representative's
            status in the `representatives` array on `GET /entities/{entity_id}`
            or via the `identity_verification.*` webhooks. The entity's
            top-level `kyc_status` reflects only the primary representative, and
            `next_step` advances once every representative has started
            verification (not once they pass), so neither confirms this
            representative's outcome.
      type: object
      required:
        - representative_id
        - kyc_status
      title: EntityRepresentativeKycResponse
    DateString:
      type: string
      format: date
      title: DateString
      description: >-
        ISO 8601 full-date in the format `YYYY-MM-DD` (per [IETF RFC
        3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
    ExtPlaidIDNumberType:
      type: string
      enum:
        - ar_dni
        - au_drivers_license
        - au_passport
        - br_cpf
        - ca_sin
        - cl_run
        - cn_resident_card
        - co_nit
        - dk_cpr
        - eg_national_id
        - es_dni
        - es_nie
        - hk_hkid
        - in_pan
        - in_epic
        - it_cf
        - jo_civil_id
        - jp_my_number
        - ke_huduma_namba
        - kw_civil_id
        - mx_curp
        - mx_rfc
        - my_nric
        - ng_nin
        - nz_drivers_license
        - om_civil_id
        - ph_psn
        - pl_pesel
        - ro_cnp
        - sa_national_id
        - se_pin
        - sg_nric
        - tr_tc_kimlik
        - us_ssn
        - us_ssn_last_4
        - za_smart_id
      title: ExtPlaidIDNumberType
      x-enum-varnames:
        - ar_dni
        - au_drivers_license
        - au_passport
        - br_cpf
        - ca_sin
        - cl_run
        - cn_resident_card
        - co_nit
        - dk_cpr
        - eg_national_id
        - es_dni
        - es_nie
        - hk_hkid
        - in_pan
        - in_epic
        - it_cf
        - jo_civil_id
        - jp_my_number
        - ke_huduma_namba
        - kw_civil_id
        - mx_curp
        - mx_rfc
        - my_nric
        - ng_nin
        - nz_drivers_license
        - om_civil_id
        - ph_psn
        - pl_pesel
        - ro_cnp
        - sa_national_id
        - se_pin
        - sg_nric
        - tr_tc_kimlik
        - us_ssn
        - us_ssn_last_4
        - za_smart_id
    OnboardingAddress:
      properties:
        address:
          type: string
          maxLength: 900
          minLength: 1
          title: Address
          description: Street address line 1.
          examples:
            - 9 Whisker Way
        address_2:
          anyOf:
            - type: string
              maxLength: 900
            - type: 'null'
          title: Address 2
          description: Street address line 2.
          examples:
            - Suite 9
        city:
          type: string
          maxLength: 300
          minLength: 1
          title: City
          description: City name.
          examples:
            - San Francisco
        state:
          anyOf:
            - type: string
              maxLength: 300
            - type: 'null'
          title: State
          description: State or province code.
          examples:
            - CA
        zip:
          type: string
          maxLength: 100
          minLength: 1
          title: Zip
          description: Postal or ZIP code.
          examples:
            - '94105'
        country:
          $ref: '#/components/schemas/CountryCodeAlpha2'
          description: ISO 3166-1 alpha-2 country code.
      type: object
      required:
        - address
        - city
        - zip
        - country
      title: OnboardingAddress
    OnboardingKycStatus:
      type: string
      enum:
        - not_started
        - pending
        - action_required
        - approved
        - rejected
      title: OnboardingKycStatus
      x-enum-varnames:
        - not_started
        - pending
        - action_required
        - approved
        - rejected
    CustomerApiError:
      oneOf:
        - $ref: '#/components/schemas/CustomerApiServiceError'
        - $ref: '#/components/schemas/CustomerApiGatewayError'
    CustomerApiGatewayError:
      type: object
      required:
        - error_code
        - message
      properties:
        error_code:
          type: string
        message:
          type: string
    CountryCodeAlpha2:
      type: string
      enum:
        - AW
        - AF
        - AO
        - AI
        - AX
        - AL
        - AD
        - AE
        - AR
        - AM
        - AS
        - AQ
        - TF
        - AG
        - AU
        - AT
        - AZ
        - BI
        - BE
        - BJ
        - BQ
        - BF
        - BD
        - BG
        - BH
        - BS
        - BA
        - BL
        - BY
        - BZ
        - BM
        - BO
        - BR
        - BB
        - BN
        - BT
        - BV
        - BW
        - CF
        - CA
        - CC
        - CH
        - CL
        - CN
        - CI
        - CM
        - CD
        - CG
        - CK
        - CO
        - KM
        - CV
        - CR
        - CU
        - CW
        - CX
        - KY
        - CY
        - CZ
        - DE
        - DJ
        - DM
        - DK
        - DO
        - DZ
        - EC
        - EG
        - ER
        - EH
        - ES
        - EE
        - ET
        - FI
        - FJ
        - FK
        - FR
        - FO
        - FM
        - GA
        - GB
        - GE
        - GG
        - GH
        - GI
        - GN
        - GP
        - GM
        - GW
        - GQ
        - GR
        - GD
        - GL
        - GT
        - GF
        - GU
        - GY
        - HK
        - HM
        - HN
        - HR
        - HT
        - HU
        - ID
        - IM
        - IN
        - IO
        - IE
        - IR
        - IQ
        - IS
        - IL
        - IT
        - JM
        - JE
        - JO
        - JP
        - KZ
        - KE
        - KG
        - KH
        - KI
        - KN
        - KR
        - KW
        - LA
        - LB
        - LR
        - LY
        - LC
        - LI
        - LK
        - LS
        - LT
        - LU
        - LV
        - MO
        - MF
        - MA
        - MC
        - MD
        - MG
        - MV
        - MX
        - MH
        - MK
        - ML
        - MT
        - MM
        - ME
        - MN
        - MP
        - MZ
        - MR
        - MS
        - MQ
        - MU
        - MW
        - MY
        - YT
        - NA
        - NC
        - NE
        - NF
        - NG
        - NI
        - NU
        - NL
        - 'NO'
        - NP
        - NR
        - NZ
        - OM
        - PK
        - PA
        - PN
        - PE
        - PH
        - PW
        - PG
        - PL
        - PR
        - KP
        - PT
        - PY
        - PS
        - PF
        - QA
        - RE
        - RO
        - RU
        - RW
        - SA
        - SD
        - SN
        - SG
        - GS
        - SH
        - SJ
        - SB
        - SL
        - SV
        - SM
        - SO
        - PM
        - RS
        - SS
        - ST
        - SR
        - SK
        - SI
        - SE
        - SZ
        - SX
        - SC
        - SY
        - TC
        - TD
        - TG
        - TH
        - TJ
        - TK
        - TM
        - TL
        - TO
        - TT
        - TN
        - TR
        - TV
        - TW
        - TZ
        - UG
        - UA
        - UM
        - UY
        - US
        - UZ
        - VA
        - VC
        - VE
        - VG
        - VI
        - VN
        - VU
        - WF
        - WS
        - XK
        - YE
        - ZA
        - ZM
        - ZW
      title: CountryCodeAlpha2
      x-enum-varnames:
        - AW
        - AF
        - AO
        - AI
        - AX
        - AL
        - AD
        - AE
        - AR
        - AM
        - AS
        - AQ
        - TF
        - AG
        - AU
        - AT
        - AZ
        - BI
        - BE
        - BJ
        - BQ
        - BF
        - BD
        - BG
        - BH
        - BS
        - BA
        - BL
        - BY
        - BZ
        - BM
        - BO
        - BR
        - BB
        - BN
        - BT
        - BV
        - BW
        - CF
        - CA
        - CC
        - CH
        - CL
        - CN
        - CI
        - CM
        - CD
        - CG
        - CK
        - CO
        - KM
        - CV
        - CR
        - CU
        - CW
        - CX
        - KY
        - CY
        - CZ
        - DE
        - DJ
        - DM
        - DK
        - DO
        - DZ
        - EC
        - EG
        - ER
        - EH
        - ES
        - EE
        - ET
        - FI
        - FJ
        - FK
        - FR
        - FO
        - FM
        - GA
        - GB
        - GE
        - GG
        - GH
        - GI
        - GN
        - GP
        - GM
        - GW
        - GQ
        - GR
        - GD
        - GL
        - GT
        - GF
        - GU
        - GY
        - HK
        - HM
        - HN
        - HR
        - HT
        - HU
        - ID
        - IM
        - IN
        - IO
        - IE
        - IR
        - IQ
        - IS
        - IL
        - IT
        - JM
        - JE
        - JO
        - JP
        - KZ
        - KE
        - KG
        - KH
        - KI
        - KN
        - KR
        - KW
        - LA
        - LB
        - LR
        - LY
        - LC
        - LI
        - LK
        - LS
        - LT
        - LU
        - LV
        - MO
        - MF
        - MA
        - MC
        - MD
        - MG
        - MV
        - MX
        - MH
        - MK
        - ML
        - MT
        - MM
        - ME
        - MN
        - MP
        - MZ
        - MR
        - MS
        - MQ
        - MU
        - MW
        - MY
        - YT
        - NA
        - NC
        - NE
        - NF
        - NG
        - NI
        - NU
        - NL
        - 'NO'
        - NP
        - NR
        - NZ
        - OM
        - PK
        - PA
        - PN
        - PE
        - PH
        - PW
        - PG
        - PL
        - PR
        - KP
        - PT
        - PY
        - PS
        - PF
        - QA
        - RE
        - RO
        - RU
        - RW
        - SA
        - SD
        - SN
        - SG
        - GS
        - SH
        - SJ
        - SB
        - SL
        - SV
        - SM
        - SO
        - PM
        - RS
        - SS
        - ST
        - SR
        - SK
        - SI
        - SE
        - SZ
        - SX
        - SC
        - SY
        - TC
        - TD
        - TG
        - TH
        - TJ
        - TK
        - TM
        - TL
        - TO
        - TT
        - TN
        - TR
        - TV
        - TW
        - TZ
        - UG
        - UA
        - UM
        - UY
        - US
        - UZ
        - VA
        - VC
        - VE
        - VG
        - VI
        - VN
        - VU
        - WF
        - WS
        - XK
        - YE
        - ZA
        - ZM
        - ZW
    CustomerApiServiceError:
      type: object
      required:
        - code
        - message
        - debug_message
      properties:
        code:
          type: integer
        message:
          type: string
        debug_message:
          type: string
  responses:
    BadRequest:
      description: The request could not be processed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CustomerApiError'
    Unauthorized:
      description: Authentication failed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CustomerApiGatewayError'
    Forbidden:
      description: The API key is not authorized for this operation.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CustomerApiGatewayError'
    RateLimited:
      description: Too many requests.
      headers:
        Retry-After:
          schema:
            type: integer
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/CustomerApiGatewayError'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Meow API key, sent in the `x-api-key` header for authentication.
      x-scopes:
        - accounts:read
        - accounts:write
        - accounts:payment-networks
        - accounts:transactions
        - accounts:balances
        - accounts:statements
        - accounts:tax-documents
        - entity:create
        - transfers:crypto:write
        - transfers:usdc:write
        - transfers:ach:write
        - transfers:wire:write
        - transfers:book:write
        - transfers:international:write
        - contacts:read
        - contacts:write
        - billing:products:read
        - billing:products:write
        - billing:customers:read
        - billing:customers:write
        - billing:invoices:read
        - billing:invoices:write
        - billing:accounts:read
        - billpay:read
        - billpay:write
        - onboarding:read
        - onboarding:write
        - cards:read
        - cards:write
        - reimbursements:read
        - users:read
        - users:write
        - webhooks:read
        - webhooks:write
        - partner:onboarding:read
        - partner:onboarding:write
        - partner:webhooks:read
        - partner:webhooks:write
        - simulations:write
        - banking:limits:read
        - banking:limits:write
        - feature-access:read
        - feature-access:write

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.