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

# Get a contact by ID

> Retrieve detailed information about a specific contact in your Quo workspace using the contact's unique identifier.



## OpenAPI

````yaml https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json get /v1/contacts/{id}
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: Production server
    url: https://api.quo.com
security:
  - apiKey: []
tags:
  - 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 conversations
    name: Conversations
  - description: Operations related to text messages
    name: Messages
  - description: Operations related to phone numbers
    name: Phone Numbers
  - description: Operations related to users
    name: Users
  - description: Operations related to webhooks
    name: Webhooks
paths:
  /v1/contacts/{id}:
    get:
      tags:
        - Contacts
      summary: Get a contact by ID
      description: >-
        Retrieve detailed information about a specific contact in your Quo
        workspace using the contact's unique identifier.
      operationId: getContactById_v1
      parameters:
        - in: path
          name: id
          required: true
          schema:
            description: The unique identifier of the contact.
            examples:
              - 66d0d87e8dc1211467372303
            pattern: ^(.*)$
            type: string
          example: 66d0d87e8dc1211467372303
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: object
                    required:
                      - id
                      - externalId
                      - source
                      - sourceUrl
                      - defaultFields
                      - customFields
                      - createdAt
                      - updatedAt
                      - createdByUserId
                    properties:
                      id:
                        description: The unique identifier of the contact.
                        examples:
                          - 664d0db69fcac7cf2e6ec
                        pattern: ^(.*)$
                        type: string
                        example: 664d0db69fcac7cf2e6ec
                      externalId:
                        anyOf:
                          - description: >-
                              A unique identifier from an external system that
                              can optionally be supplied when creating a
                              contact. This ID is used to associate the contact
                              with records in other systems and is required for
                              retrieving the contact later via the "List
                              Contacts" endpoint. Ensure the `externalId` is
                              unique and consistent across systems for accurate
                              cross-referencing.
                            examples:
                              - 664d0db69fcac7cf2e6ec
                            minLength: 1
                            maxLength: 75
                            type: string
                            example: 664d0db69fcac7cf2e6ec
                          - type: 'null'
                      source:
                        anyOf:
                          - description: >-
                              Indicates how the contact was created or where it
                              originated from.
                            examples:
                              - public-api
                            minLength: 1
                            maxLength: 75
                            type: string
                            example: public-api
                          - type: 'null'
                      sourceUrl:
                        anyOf:
                          - description: A link to the contact in the source system.
                            format: uri
                            examples:
                              - >-
                                https://openphone.co/contacts/664d0db69fcac7cf2e6ec
                            minLength: 1
                            maxLength: 200
                            type: string
                            example: >-
                              https://openphone.co/contacts/664d0db69fcac7cf2e6ec
                          - type: 'null'
                      defaultFields:
                        type: object
                        required:
                          - company
                          - emails
                          - firstName
                          - lastName
                          - phoneNumbers
                          - role
                        properties:
                          company:
                            anyOf:
                              - description: The contact's company name.
                                examples:
                                  - Quo
                                type: string
                                example: Quo
                              - type: 'null'
                          emails:
                            type: array
                            items:
                              type: object
                              required:
                                - name
                                - value
                              properties:
                                name:
                                  description: The name for the contact's email address.
                                  examples:
                                    - company email
                                  type: string
                                  example: company email
                                value:
                                  anyOf:
                                    - description: The contact's email address.
                                      examples:
                                        - abc@example.com
                                      type: string
                                      example: abc@example.com
                                    - type: 'null'
                                id:
                                  description: >-
                                    The unique identifier for the contact email
                                    field.
                                  examples:
                                    - acb123
                                  type: string
                                  example: acb123
                          firstName:
                            anyOf:
                              - description: The contact's first name.
                                examples:
                                  - John
                                type: string
                                example: John
                              - type: 'null'
                          lastName:
                            anyOf:
                              - description: The contact's last name.
                                examples:
                                  - Doe
                                type: string
                                example: Doe
                              - type: 'null'
                          phoneNumbers:
                            type: array
                            items:
                              type: object
                              required:
                                - name
                                - value
                              properties:
                                name:
                                  description: The name of the contact's phone number.
                                  examples:
                                    - company phone
                                  type: string
                                  example: company phone
                                value:
                                  anyOf:
                                    - description: The contact's phone number.
                                      examples:
                                        - '+12345678901'
                                      type: string
                                      example: '+12345678901'
                                    - type: 'null'
                                id:
                                  description: >-
                                    The unique identifier of the contact phone
                                    number field.
                                  examples:
                                    - acb123
                                  type: string
                                  example: acb123
                          role:
                            anyOf:
                              - description: The contact's role.
                                examples:
                                  - Sales
                                type: string
                                example: Sales
                              - type: 'null'
                      customFields:
                        type: array
                        items:
                          allOf:
                            - type: object
                              required:
                                - name
                              properties:
                                name:
                                  description: >-
                                    The name of the custom contact field. This
                                    name is set by users in the Quo interface
                                    when the custom field is created.
                                  examples:
                                    - Inbound Lead
                                  type: string
                                  example: Inbound Lead
                                key:
                                  description: >-
                                    The identifying key for contact custom
                                    field.
                                  examples:
                                    - inbound-lead
                                  type: string
                                  example: inbound-lead
                                id:
                                  description: >-
                                    The unique identifier for the contact custom
                                    field.
                                  examples:
                                    - 66d0d87d534de8fd1c433cec3
                                  type: string
                                  example: 66d0d87d534de8fd1c433cec3
                            - anyOf:
                                - type: object
                                  required:
                                    - type
                                    - value
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - multi-select
                                    value:
                                      description: >-
                                        Value defined for the multi select type
                                        custom field.
                                      examples:
                                        - - option1
                                          - option2
                                      example:
                                        - option1
                                        - option2
                                      anyOf:
                                        - type: array
                                          items:
                                            type: string
                                        - type: 'null'
                                - type: object
                                  required:
                                    - type
                                    - value
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - address
                                        - string
                                        - url
                                    value:
                                      description: >-
                                        Value defined for the address, string,
                                        or url type custom field.
                                      examples:
                                        - 123 Main St
                                      example: 123 Main St
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                - type: object
                                  required:
                                    - type
                                    - value
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - boolean
                                    value:
                                      description: >-
                                        Value defined for the boolean type
                                        custom field.
                                      examples:
                                        - 'false'
                                      example: 'false'
                                      anyOf:
                                        - type: boolean
                                        - type: 'null'
                                - type: object
                                  required:
                                    - type
                                    - value
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - date
                                    value:
                                      description: >-
                                        Value defined for the date type custom
                                        fields.
                                      examples:
                                        - '2024-09-11T04:00:00.000Z'
                                      example: '2024-09-11T04:00:00.000Z'
                                      anyOf:
                                        - format: date-time
                                          type: string
                                        - type: 'null'
                                - type: object
                                  required:
                                    - type
                                    - value
                                  properties:
                                    type:
                                      type: string
                                      enum:
                                        - number
                                    value:
                                      description: Value for the number custom field.
                                      examples:
                                        - '424242'
                                      example: '424242'
                                      anyOf:
                                        - type: number
                                        - type: 'null'
                      createdAt:
                        description: Timestamp of contact creation in ISO 8601 format.
                        examples:
                          - '2022-01-01T00:00:00Z'
                        format: date-time
                        type: string
                        example: '2022-01-01T00:00:00Z'
                      updatedAt:
                        description: Timestamp of last contact update in ISO 8601 format.
                        examples:
                          - '2022-01-01T00:00:00Z'
                        format: date-time
                        type: string
                        example: '2022-01-01T00:00:00Z'
                      createdByUserId:
                        description: >-
                          The unique identifier of the user who created the
                          contact.
                        examples:
                          - US123abc
                        pattern: ^US(.*)$
                        type: string
                        example: US123abc
        '400':
          description: Invalid Custom Field Item
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                  - description
                properties:
                  message:
                    type: string
                  code:
                    const: '0801400'
                    type: string
                  status:
                    const: 400
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Invalid Custom Field Item
                    type: string
                  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
                  description:
                    const: Invalid Custom Field Item
                    type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    const: '0800401'
                    type: string
                  status:
                    const: 401
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Unauthorized
                    type: string
                  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
        '403':
          description: Not Phone Number User
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                  - description
                properties:
                  message:
                    type: string
                  code:
                    const: '0801403'
                    type: string
                  status:
                    const: 403
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Not Phone Number User
                    type: string
                  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
                  description:
                    const: Not Phone Number User
                    type: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    const: '0800404'
                    type: string
                  status:
                    const: 404
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Not Found
                    type: string
                  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
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    const: '0800409'
                    type: string
                  status:
                    const: 409
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Conflict
                    type: string
                  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
        '500':
          description: Unknown Error
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    const: '0801500'
                    type: string
                  status:
                    const: 500
                    type: number
                  docs:
                    const: https://quo.com/docs
                    type: string
                  title:
                    const: Unknown
                    type: string
                  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
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      in: header
      name: Authorization
      type: apiKey

````