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

# List registrations



## OpenAPI

````yaml /openapi.json get /registrations
openapi: 3.1.0
info:
  title: FastCAC API
  description: Register Nigerian businesses with CAC from your own product.
  version: '2026-11-01'
servers:
  - url: https://api.fastcac.com/v1
security:
  - apiKey: []
tags:
  - name: Account
    description: Check your key and see your organization.
  - name: Name checks
    description: >-
      Check a business name against CAC's rules and registry before registering
      it.
  - name: Registrations
    description: Register a Business Name with CAC, from draft to certificate.
  - name: Test helpers
    description: 'Test keys only: move a registration on without waiting.'
  - name: Webhooks
    description: Endpoints that receive events, and the events sent to them.
  - name: Webhook events
    description: What FastCAC POSTs to your webhook endpoints.
paths:
  /registrations:
    get:
      tags:
        - Registrations
      summary: List registrations
      operationId: list_registrations_registrations_get
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 20
            title: Limit
        - name: starting_after
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: A reg_… id from the previous page.
            title: Starting After
          description: A reg_… id from the previous page.
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Status
        - name: external_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 255
              - type: 'null'
            title: External Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V1RegistrationList'
              examples:
                Example:
                  value:
                    object: list
                    data:
                      - object: registration
                        id: reg_4kMzPP2CrSMnY18kiANzau
                        business_id: biz_68mJv5UBBIPdMGYTvhnrKG
                        external_id: order-1182
                        type: business_name
                        status: approved
                        proposed_names:
                          - ADA FOODS VENTURES
                          - ADA KITCHEN VENTURES
                        line_of_business: Educational Services And Consultancy
                        business:
                          email: hello@adafoods.ng
                          phone: '08039876543'
                          address:
                            street_number: '12'
                            street: Admiralty Way
                            city: Lekki
                            lga: Eti-Osa
                            state: Lagos
                            postcode: '105102'
                        proprietors:
                          - first_name: Ada
                            last_name: Obi
                            other_names: null
                            gender: female
                            date_of_birth: '1990-04-12'
                            nationality: Nigerian
                            nin: '12345678901'
                            email: ada@example.com
                            phone: '08031234567'
                            address:
                              street_number: '12'
                              street: Admiralty Way
                              city: Lekki
                              lga: Eti-Osa
                              state: Lagos
                              postcode: '105102'
                        missing_fields: []
                        query: null
                        failure: null
                        registered_name: ADA FOODS VENTURES
                        registration_number: '1301371'
                        certificate_available: true
                        status_report_available: true
                        history:
                          - from: null
                            to: draft
                            at: '2026-10-23T22:17:57Z'
                          - from: draft
                            to: pending_payment
                            at: '2026-10-23T22:17:58Z'
                          - from: pending_payment
                            to: paid
                            at: '2026-10-23T22:17:58Z'
                          - from: paid
                            to: submitted
                            at: '2026-10-23T22:17:58Z'
                          - from: submitted
                            to: approved
                            at: '2026-10-23T22:17:58Z'
                        submitted_at: '2026-10-23T22:17:58Z'
                        approved_at: '2026-10-23T22:17:58Z'
                        created_at: '2026-10-23T22:17:57Z'
                        updated_at: '2026-10-23T22:17:58Z'
                    has_more: false
        '400':
          description: The request is invalid; `param` names the field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: The API key is missing, malformed, revoked or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Example:
                  value:
                    error:
                      type: authentication_error
                      code: api_key_missing
                      message: 'Send your API key as `Authorization: Bearer <key>`.'
                      param: null
                      request_id: req_kdwpKsFMKS4VzLjqZJ0ntdrl
        '403':
          description: >-
            The key can't do this (for example, live registrations before they
            open).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Example:
                  value:
                    error:
                      type: permission_error
                      code: live_mode_unavailable
                      message: >-
                        Live registrations aren't open yet. Use a test key
                        (fc_test_…) for now.
                      param: null
                      request_id: req_oYVCIHqeYbgIA3lIzwG0PO5r
        '404':
          description: No such object for this key's organization and mode.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Example:
                  value:
                    error:
                      type: not_found_error
                      code: resource_missing
                      message: 'No such registration: reg_0000000000000000000000.'
                      param: id
                      request_id: req_RlcFqswqrJZos4pnRMH3wa8d
        '409':
          description: >-
            The object's state doesn't allow this, or the Idempotency-Key was
            reused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many requests; wait for `Retry-After` seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    V1RegistrationList:
      properties:
        object:
          type: string
          const: list
          title: Object
          default: list
        data:
          items:
            $ref: '#/components/schemas/V1Registration'
          type: array
          title: Data
        has_more:
          type: boolean
          title: Has More
          description: Pass the last id as starting_after for the next page.
      type: object
      required:
        - data
        - has_more
      title: V1RegistrationList
    Error:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      required:
        - error
      title: V1Error
      type: object
    V1Registration:
      properties:
        object:
          type: string
          const: registration
          title: Object
          default: registration
        id:
          type: string
          title: Id
          description: reg_…
        business_id:
          type: string
          title: Business Id
          description: biz_…, the business this registers.
        external_id:
          anyOf:
            - type: string
            - type: 'null'
          title: External Id
          description: Your own reference.
        type:
          type: string
          const: business_name
          title: Type
        status:
          type: string
          enum:
            - draft
            - pending_payment
            - paid
            - verification_failed
            - submitted
            - queried
            - approved
            - rejected
          title: Status
        proposed_names:
          items:
            type: string
          type: array
          title: Proposed Names
          description: One or two, in order of preference, upper case.
        line_of_business:
          anyOf:
            - type: string
            - type: 'null'
          title: Line Of Business
        business:
          anyOf:
            - $ref: '#/components/schemas/Business'
            - type: 'null'
        proprietors:
          items:
            $ref: '#/components/schemas/Proprietor'
          type: array
          title: Proprietors
        missing_fields:
          items:
            type: string
          type: array
          title: Missing Fields
          description: What a draft still needs before submit, as parameter paths.
        query:
          anyOf:
            - $ref: '#/components/schemas/V1Query'
            - type: 'null'
          description: What CAC asked, once queried.
        failure:
          anyOf:
            - $ref: '#/components/schemas/V1Failure'
            - type: 'null'
        registered_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Registered Name
          description: Once approved.
        registration_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Registration Number
          description: CAC's Business Name number (seven digits), once approved.
        certificate_available:
          type: boolean
          title: Certificate Available
        status_report_available:
          type: boolean
          title: Status Report Available
        history:
          items:
            $ref: '#/components/schemas/V1HistoryEntry'
          type: array
          title: History
          description: Every status change, oldest first.
        submitted_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Submitted At
        approved_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Approved At
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Updated At
      type: object
      required:
        - id
        - business_id
        - external_id
        - type
        - status
        - proposed_names
        - line_of_business
        - business
        - proprietors
        - missing_fields
        - query
        - failure
        - registered_name
        - registration_number
        - certificate_available
        - status_report_available
        - history
        - submitted_at
        - approved_at
        - created_at
        - updated_at
      title: V1Registration
    ErrorDetail:
      properties:
        type:
          enum:
            - invalid_request_error
            - authentication_error
            - permission_error
            - idempotency_error
            - rate_limit_error
            - api_error
          title: Type
          type: string
        code:
          description: Stable and machine-readable, e.g. registration_incomplete.
          title: Code
          type: string
        message:
          description: For a developer to read; may change.
          title: Message
          type: string
        param:
          anyOf:
            - type: string
            - type: 'null'
          description: The parameter at fault, as a path like proprietors[0].nin.
          title: Param
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          description: Also in the FastCAC-Request-Id header. Quote it to support.
          title: Request Id
      required:
        - type
        - code
        - message
        - param
        - request_id
      title: ErrorDetail
      type: object
    Business:
      properties:
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
        phone:
          anyOf:
            - type: string
            - type: 'null'
          title: Phone
        address:
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
      type: object
      title: Business
    Proprietor:
      properties:
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          title: First Name
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Name
        other_names:
          anyOf:
            - type: string
            - type: 'null'
          title: Other Names
        gender:
          anyOf:
            - type: string
              enum:
                - male
                - female
            - type: 'null'
          title: Gender
        date_of_birth:
          anyOf:
            - type: string
            - type: 'null'
          title: Date Of Birth
          description: YYYY-MM-DD. Proprietors must be 18 or older.
        nationality:
          anyOf:
            - type: string
            - type: 'null'
          title: Nationality
          description: Business Name proprietors must be Nigerian.
          default: Nigerian
        nin:
          anyOf:
            - type: string
            - type: 'null'
          title: Nin
          description: National Identification Number, 11 digits.
        email:
          anyOf:
            - type: string
            - type: 'null'
          title: Email
        phone:
          anyOf:
            - type: string
            - type: 'null'
          title: Phone
        address:
          anyOf:
            - $ref: '#/components/schemas/Address'
            - type: 'null'
      type: object
      title: Proprietor
    V1Query:
      properties:
        raised_at:
          type: string
          title: Raised At
        answered_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Answered At
          description: When you resubmitted.
        items:
          items:
            $ref: '#/components/schemas/V1QueryItem'
          type: array
          title: Items
      type: object
      required:
        - raised_at
        - answered_at
        - items
      title: V1Query
    V1Failure:
      properties:
        code:
          type: string
          title: Code
          description: nin_mismatch (verification_failed) or rejected_by_cac (rejected).
        message:
          type: string
          title: Message
        fields:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Fields
          description: What to fix, as parameter paths.
      type: object
      required:
        - code
        - message
      title: V1Failure
    V1HistoryEntry:
      properties:
        from:
          anyOf:
            - type: string
              enum:
                - draft
                - pending_payment
                - paid
                - verification_failed
                - submitted
                - queried
                - approved
                - rejected
            - type: 'null'
          title: From
        to:
          type: string
          enum:
            - draft
            - pending_payment
            - paid
            - verification_failed
            - submitted
            - queried
            - approved
            - rejected
          title: To
        at:
          type: string
          title: At
      type: object
      required:
        - from
        - to
        - at
      title: V1HistoryEntry
    Address:
      properties:
        street_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Street Number
        street:
          anyOf:
            - type: string
            - type: 'null'
          title: Street
        city:
          anyOf:
            - type: string
            - type: 'null'
          title: City
        lga:
          anyOf:
            - type: string
            - type: 'null'
          title: Lga
          description: Local government area.
        state:
          anyOf:
            - type: string
            - type: 'null'
          title: State
        postcode:
          anyOf:
            - type: string
            - type: 'null'
          title: Postcode
          description: Six digits.
      type: object
      title: Address
    V1QueryItem:
      properties:
        field:
          anyOf:
            - type: string
            - type: 'null'
          title: Field
          description: >-
            The parameter to fix, e.g. proprietors[0].documents.passport; null
            when CAC didn't tie the item to one field.
        code:
          type: string
          enum:
            - name_exists
            - qualifier_missing
            - single_word
            - offensive_language
            - fraudulent_association
            - document_unclear
            - name_mismatch
            - other
          title: Code
        message:
          type: string
          title: Message
          description: CAC's own words.
        resolved:
          type: boolean
          title: Resolved
          description: >-
            The field has changed (or the document was replaced) since the
            query.
      type: object
      required:
        - field
        - code
        - message
        - resolved
      title: V1QueryItem
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: 'Your secret API key: fc_test_… in test mode, fc_live_… in live mode.'

````

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