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

# Retrieve Contact

> Retrieves a contact by ID



## OpenAPI

````yaml GET /contacts/{id}
openapi: 3.0.1
info:
  title: OpenAPI Letterby
  description: API for Letterby
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://letterby.com/api/v4
security:
  - apiKeyAuth: []
paths:
  /contacts/{id}:
    get:
      description: Retrieves a contact by ID
      parameters:
        - name: id
          in: path
          required: true
          description: ID of the contact to retrieve
          schema:
            type: string
      responses:
        '200':
          description: Contact retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      contact:
                        $ref: '#/components/schemas/ContactWithPosition'
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Contact not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ContactWithPosition:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the contact
        email:
          type: string
          description: Email address of the contact
        firstName:
          type: string
          description: First name of the contact
        lastName:
          type: string
          description: Last name of the contact
        phoneNumber:
          type: string
          description: Phone number of the contact
        createdAt:
          type: string
          format: date-time
          description: When the contact was created
        points:
          type: integer
          description: Points accumulated by the contact
        referrals:
          type: integer
          description: Number of referrals by the contact
        listId:
          type: string
          description: ID of the list this contact belongs to
        isVerified:
          type: boolean
          description: Whether the contact is verified
        unsubscribed:
          type: boolean
          description: Whether the contact has unsubscribed
        data:
          type: object
          description: Custom data associated with the contact
        address:
          type: string
          description: Contact's address
        isGDPR:
          type: boolean
          description: Whether the contact has GDPR consent
        name:
          type: string
          description: Full name of the contact
        instagram:
          type: string
          description: Instagram handle
        twitter:
          type: string
          description: Twitter handle
        website:
          type: string
          description: Personal website URL
        company:
          type: string
          description: Company name
        country:
          type: string
          description: Country of residence
        city:
          type: string
          description: City of residence
        list:
          type: object
          description: Associated list information
          properties:
            id:
              type: string
              description: List ID
            name:
              type: string
              description: List name
            url:
              type: string
              description: List URL identifier
            mode:
              type: string
              description: List mode
            referrals:
              type: boolean
              description: Whether referrals are enabled
            color:
              type: string
              description: List primary color
            title:
              type: string
              description: List title
            desc:
              type: string
              description: List description
        audiences:
          type: array
          description: Audiences this contact belongs to
        referralLink:
          type: string
          description: Contact's referral link
        privateLink:
          type: string
          description: Contact's private subscriber page URL
        position:
          type: integer
          description: Position in the list ranking
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: apiKey
      description: API key to authorize requests

````