> ## Documentation Index
> Fetch the complete documentation index at: https://openphone-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the A2P registration

> Get the organization's A2P (10DLC) registration. Organizations have at most one registration. Returns a 404 rather than a null `data` field when no registration exists yet.



## OpenAPI

````yaml https://openphone-public-api-dev.s3.us-west-2.amazonaws.com/public/openphone-public-api-2026-03-30-dev.json get /a2p-registration
openapi: 3.1.0
info:
  title: Quo Public API
  version: 1.0.0
  description: API for connecting with Quo.
  contact:
    name: Quo Support
    email: support@quo.com
    url: https://support.quo.com/
  termsOfService: https://www.quo.com/terms
servers:
  - description: Development server
    url: https://dev-public-api.openphone.dev
security:
  - apiKey: []
tags:
  - description: Operations related to the organization's A2P registration
    name: A2P Registration
  - description: Operations related to calls placed by an AI agent
    name: Agent Calls
  - description: Operations related to text conversations held by an AI agent
    name: Agent Conversations
  - description: Operations related to calls
    name: Calls
  - description: >-
      Operations related to call summaries, including AI-generated summaries and
      Sona voice assistant summaries
    name: Call Summaries
  - description: >-
      Operations related to call transcripts, including AI-generated transcripts
      and Sona voice assistant transcripts
    name: Call Transcripts
  - description: Operations related to contacts
    name: Contacts
  - description: Operations related to contact shares
    name: Contact Shares
  - description: Operations related to contact notes
    name: Contact Notes
  - description: Operations related to contact properties
    name: Contact Properties
  - description: Operations related to conversations
    name: Conversations
  - description: Operations related to workspace invitations
    name: Invites
  - description: Operations related to text messages
    name: Messages
  - description: Operations related to the organization
    name: Organization
  - description: Operations related to phone numbers
    name: Phone Numbers
  - description: Operations related to users
    name: Users
  - description: Operations related to webhooks
    name: Webhooks
  - description: >-
      Operations related to webhook events, including delivery history and test
      events
    name: Webhook Events
paths:
  /a2p-registration:
    get:
      tags:
        - A2P Registration
      summary: Get the A2P registration
      description: >-
        Get the organization's A2P (10DLC) registration. Organizations have at
        most one registration. Returns a 404 rather than a null `data` field
        when no registration exists yet.
      operationId: getA2PRegistration
      parameters:
        - in: header
          name: Quo-Api-Version
          required: true
          schema:
            type: string
            enum:
              - '2026-03-30'
            description: 'API version header. Supported values: 2026-03-30'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: object
                    required:
                      - id
                      - draft
                      - status
                      - statusMessages
                      - type
                      - assignedPnId
                      - firstSubmittedAt
                      - createdAt
                      - updatedAt
                      - businessInfo
                      - messaging
                    properties:
                      id:
                        description: The unique identifier of the A2P registration.
                        examples:
                          - RG123abc
                        example: RG123abc
                        type: string
                        pattern: ^RG(.*)$
                      draft:
                        type: boolean
                        description: >-
                          True if the registration has not yet been submitted
                          for carrier approval. Combine with `status` to tell
                          submission states apart: `draft: true, status:
                          "pending"` means not yet submitted; `draft: false,
                          status: "pending"` means submitted and awaiting
                          carrier approval.
                      status:
                        anyOf:
                          - type: string
                            const: pending
                          - type: string
                            const: approved
                          - type: string
                            const: rejected
                          - type: string
                            const: failed
                        description: >-
                          The registration's overall status. `pending` is set
                          both at creation and while awaiting carrier approval
                          after submission — check `draft` to tell those two
                          apart. `rejected` and `failed` both mean the
                          registration must be resubmitted, which re-triggers
                          billing.
                        examples:
                          - pending
                        example: pending
                      statusMessages:
                        type: array
                        items:
                          type: object
                          required:
                            - errorCode
                            - errorReason
                          properties:
                            errorCode:
                              type: number
                              description: >-
                                The carrier error code associated with this
                                status message.
                            errorReason:
                              type: string
                              description: A human-readable explanation of the status.
                            fieldName:
                              type: string
                              description: >-
                                The single business-profile field this message
                                refers to, if any.
                            fields:
                              type: array
                              items:
                                type: string
                              description: >-
                                The business-profile fields this message refers
                                to, if any.
                        description: >-
                          Carrier-reported reasons for the current status, most
                          relevant when `status` is `rejected` or `failed`.
                      type:
                        anyOf:
                          - anyOf:
                              - type: string
                                const: standard
                              - type: string
                                const: lv-standard
                              - type: string
                                const: starter
                              - type: string
                                const: sole-prop
                            description: The type of A2P registration.
                            examples:
                              - standard
                            example: standard
                          - type: 'null'
                      assignedPnId:
                        anyOf:
                          - type: string
                            pattern: ^PN(.*)$
                          - type: 'null'
                      firstSubmittedAt:
                        anyOf:
                          - description: >-
                              The timestamp the registration was first submitted
                              for carrier approval.
                            type: string
                            format: date-time
                          - type: 'null'
                      createdAt:
                        description: The timestamp the registration was created.
                        type: string
                        format: date-time
                      updatedAt:
                        description: The timestamp the registration was last updated.
                        type: string
                        format: date-time
                      businessInfo:
                        type: object
                        required:
                          - name
                          - alternateName
                          - businessType
                          - companyType
                          - industry
                          - employeeCount
                          - avgDailyCallVolume
                          - regionsOfOperation
                          - websiteUrl
                          - useOpHostedPrivacyPolicy
                          - idType
                          - idNumber
                          - ticker
                          - exchange
                          - address
                          - personOfContact
                        properties:
                          name:
                            anyOf:
                              - type: string
                                description: The legal or registered name of the business.
                                examples:
                                  - Acme Inc
                                example: Acme Inc
                              - type: 'null'
                          alternateName:
                            anyOf:
                              - type: string
                                description: >-
                                  An alternate or doing-business-as name for the
                                  business.
                              - type: 'null'
                          businessType:
                            anyOf:
                              - type: string
                                description: The legal structure of the business.
                                examples:
                                  - Limited Liability Corporation
                                example: Limited Liability Corporation
                              - type: 'null'
                          companyType:
                            anyOf:
                              - anyOf:
                                  - type: string
                                    const: Private
                                  - type: string
                                    const: Public
                                  - type: string
                                    const: Non-profit
                                  - type: string
                                    const: Government
                                description: >-
                                  The type of company: one of `Private`,
                                  `Public`, `Non-profit`, `Government`.
                                examples:
                                  - Private
                                example: Private
                              - type: 'null'
                          industry:
                            anyOf:
                              - type: string
                                description: The industry the business operates in.
                              - type: 'null'
                          employeeCount:
                            anyOf:
                              - type: number
                                description: The number of employees at the business.
                              - type: 'null'
                          avgDailyCallVolume:
                            anyOf:
                              - type: number
                                description: The business's average daily call volume.
                              - type: 'null'
                          regionsOfOperation:
                            type: array
                            items:
                              anyOf:
                                - type: string
                                  const: Africa
                                - type: string
                                  const: Asia
                                - type: string
                                  const: Europe
                                - type: string
                                  const: Latin America
                                - type: string
                                  const: USA and Canada
                            description: >-
                              The regions the business operates in. Each entry
                              is one of `Africa`, `Asia`, `Europe`, `Latin
                              America`, `USA and Canada`.
                          websiteUrl:
                            anyOf:
                              - type: string
                                description: The business's website URL.
                                format: uri
                              - type: 'null'
                          useOpHostedPrivacyPolicy:
                            anyOf:
                              - type: boolean
                                description: >-
                                  Whether the business is using Quo's hosted
                                  privacy policy in place of its own.
                              - type: 'null'
                          idType:
                            anyOf:
                              - anyOf:
                                  - type: string
                                    const: 'Australia: Company Number from ASIC (ACN)'
                                  - type: string
                                    const: 'Canada: Business Number (BIN)'
                                  - type: string
                                    const: 'Canada: Canadian Business Number (BN-9)'
                                  - type: string
                                    const: 'Canada: Canadian Corporation Number (CCN)'
                                  - type: string
                                    const: 'Estonia: VAT Number'
                                  - type: string
                                    const: 'Great Britain: Company Number'
                                  - type: string
                                    const: 'India: Corporate Identity Number'
                                  - type: string
                                    const: 'Israel: Registration Number'
                                  - type: string
                                    const: 'Romania: VAT Registration Number'
                                  - type: string
                                    const: 'USA: DUNS Number (Dun & Bradstreet)'
                                  - type: string
                                    const: 'USA: Employer Identification Number (EIN)'
                                  - type: string
                                    const: Other
                                description: >-
                                  The type of the business's government-issued
                                  tax ID: one of `Australia: Company Number from
                                  ASIC (ACN)`, `Canada: Business Number (BIN)`,
                                  `Canada: Canadian Business Number (BN-9)`,
                                  `Canada: Canadian Corporation Number (CCN)`,
                                  `Estonia: VAT Number`, `Great Britain: Company
                                  Number`, `India: Corporate Identity Number`,
                                  `Israel: Registration Number`, `Romania: VAT
                                  Registration Number`, `USA: DUNS Number (Dun &
                                  Bradstreet)`, `USA: Employer Identification
                                  Number (EIN)`, `Other`.
                                examples:
                                  - 'USA: Employer Identification Number (EIN)'
                                example: 'USA: Employer Identification Number (EIN)'
                              - type: 'null'
                          idNumber:
                            anyOf:
                              - type: string
                                description: >-
                                  The business's government-issued tax ID
                                  number.
                              - type: 'null'
                          ticker:
                            anyOf:
                              - type: string
                                description: >-
                                  The business's stock ticker symbol, if
                                  publicly traded.
                              - type: 'null'
                          exchange:
                            anyOf:
                              - type: string
                                description: >-
                                  The stock exchange the business's ticker is
                                  listed on, if publicly traded.
                              - type: 'null'
                          address:
                            type: object
                            required:
                              - line1
                              - line2
                              - city
                              - region
                              - postalCode
                              - country
                            properties:
                              line1:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The first line of the business's
                                      registered address.
                                  - type: 'null'
                              line2:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The second line of the business's
                                      registered address.
                                  - type: 'null'
                              city:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The city of the business's registered
                                      address.
                                  - type: 'null'
                              region:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The state or region of the business's
                                      registered address.
                                  - type: 'null'
                              postalCode:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The postal code of the business's
                                      registered address.
                                  - type: 'null'
                              country:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The country of the business's registered
                                      address.
                                    examples:
                                      - US
                                    example: US
                                  - type: 'null'
                          personOfContact:
                            type: object
                            required:
                              - firstName
                              - lastName
                              - jobTitle
                              - jobPosition
                              - email
                              - phoneNumber
                            properties:
                              firstName:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The first name of the business contact
                                      submitting this registration.
                                  - type: 'null'
                              lastName:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The last name of the business contact
                                      submitting this registration.
                                  - type: 'null'
                              jobTitle:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The job title of the business contact
                                      submitting this registration.
                                  - type: 'null'
                              jobPosition:
                                anyOf:
                                  - type: string
                                    description: >-
                                      The job position of the business contact
                                      submitting this registration.
                                  - type: 'null'
                              email:
                                anyOf:
                                  - type: string
                                    description: The business contact's email address.
                                    format: email
                                  - type: 'null'
                              phoneNumber:
                                anyOf:
                                  - type: string
                                    description: The business contact's phone number.
                                  - type: 'null'
                      messaging:
                        type: object
                        required:
                          - useCase
                          - description
                          - samples
                          - flow
                          - personalUse
                          - consent
                        properties:
                          useCase:
                            anyOf:
                              - type: string
                                description: >-
                                  The messaging use case this registration was
                                  created for.
                              - type: 'null'
                          description:
                            anyOf:
                              - type: string
                                description: >-
                                  A description of the messages the business
                                  sends.
                              - type: 'null'
                          samples:
                            type: array
                            items:
                              type: string
                            description: Sample messages submitted for carrier vetting.
                          flow:
                            anyOf:
                              - type: string
                                description: >-
                                  A description of how end users opt in to
                                  receive messages from the business.
                              - type: 'null'
                          personalUse:
                            anyOf:
                              - type: boolean
                                description: >-
                                  Whether this registration is for an individual
                                  sending messages personally.
                              - type: 'null'
                          consent:
                            anyOf:
                              - type: object
                                properties:
                                  digitalForm:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                                  mobileApp:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                                  onSite:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                                  other:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                                  physicalForm:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                                  textMessage:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                                  verbal:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                                  websiteForm:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                                  written:
                                    type: object
                                    required:
                                      - enabled
                                    properties:
                                      enabled:
                                        type: boolean
                                        description: Whether this consent channel is in use.
                                      askForConsentExample:
                                        type: string
                                        description: >-
                                          An example of how consent is requested
                                          through this channel.
                                      screenshotUrl:
                                        type: string
                                        description: >-
                                          A screenshot demonstrating this consent
                                          channel.
                                      storeUrl:
                                        type: string
                                        description: >-
                                          The app store URL for this consent
                                          channel.
                                      text:
                                        type: string
                                        description: >-
                                          The consent text shown to the end user
                                          through this channel.
                                      url:
                                        type: string
                                        description: >-
                                          A URL demonstrating or hosting this
                                          consent channel.
                              - type: 'null'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  docs:
                    type: string
                    const: https://quo.com/docs
                  title:
                    type: string
                    const: Bad Request
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: The input was invalid
                docs: https://quo.com/docs
                title: Bad Request
                trace: '6897907457496870895'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  docs:
                    type: string
                    const: https://quo.com/docs
                  title:
                    type: string
                    const: Unauthorized
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: User is unauthorized to perform this action
                docs: https://quo.com/docs
                title: Unauthorized
                trace: '6897907457496870895'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  docs:
                    type: string
                    const: https://quo.com/docs
                  title:
                    type: string
                    const: Forbidden
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: User is forbidden to perform this action
                docs: https://quo.com/docs
                title: Forbidden
                trace: '6897907457496870895'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  docs:
                    type: string
                    const: https://quo.com/docs
                  title:
                    type: string
                    const: Not Found
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: The organization has no A2P registration
                docs: https://quo.com/docs
                title: Not Found
                trace: '6897907457496870895'
        '500':
          description: Unknown Error
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  docs:
                    type: string
                    const: https://quo.com/docs
                  title:
                    type: string
                    const: Unknown
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
              example:
                message: An unknown error has occurred
                docs: https://quo.com/docs
                title: Unknown Error
                trace: '6897907457496870895'
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      in: header
      name: Authorization
      type: apiKey

````