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

# Retrieve an applicant



## OpenAPI

````yaml /openapi/application-api.json get /v1/applicants/{id}
openapi: 3.1.0
info:
  description: >-
    Partner API for creating invites, tracking applications, and retrieving
    bonds.
  title: TheGuarantors Application API
  contact: {}
  version: '1.0'
servers:
  - url: https://api.theguarantors.com
security: []
paths:
  /v1/applicants/{id}:
    get:
      tags:
        - Applicants
      summary: Retrieve an applicant
      parameters:
        - description: Applicant ID
          name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnrichedApplicant'
              example:
                application_id: sd_3k29dls92jf83kdl
                invite_recipient_id: ivre_q7ghmgtaavp37krc
                applicant:
                  id: applc_e91hmctvoraymdpu
                  status: submitted
                  first_name: Jane
                  last_name: Doe
                  email: jane.doe@example.com
                  phone_number: '+12125551234'
                  metadata: {}
                  object: applicant
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: Missing authorization header
                object: error
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: applicant not found
                object: error
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                message: internal server error
                object: error
      security:
        - BasicAuth: []
components:
  schemas:
    EnrichedApplicant:
      type: object
      required:
        - applicant
        - application_id
        - invite_recipient_id
      properties:
        applicant:
          $ref: '#/components/schemas/Applicant'
        application_id:
          description: The ID of the application this applicant belongs to.
          type: string
          example: sd_01HQ8Z
        invite_recipient_id:
          description: The ID of the invite recipient this applicant originated from.
          type: string
          example: ivre_01HQ8Y
    ErrorResponse:
      type: object
      required:
        - message
        - object
      properties:
        message:
          type: string
          example: invite not found
        object:
          type: string
          example: error
    Applicant:
      type: object
      required:
        - email
        - first_name
        - id
        - last_name
        - object
        - status
      properties:
        email:
          type: string
          example: dana.whitfield@example.com
        first_name:
          type: string
          example: Dana
        id:
          description: Unique identifier.
          type: string
          example: applc_01HQ9A
        last_name:
          type: string
          example: Whitfield
        metadata:
          description: >-
            Key-value object. Use this field to include internal references,
            identifiers, or any additional data that helps link this lease to
            your internal system. Each key must be a string, and values can be
            strings, numbers, booleans, or null.
          type: object
          nullable: true
        object:
          type: string
          example: applicant
        phone_number:
          description: E.164 formatted phone number
          type: string
          example: '+15551234567'
          nullable: true
        status:
          description: >-
            Enum representing the applicant's current state in the application
            process.
          allOf:
            - $ref: '#/components/schemas/ApplicantStatus'
          example: submitted
    ApplicantStatus:
      type: string
      enum:
        - not_started
        - started
        - submitted
      x-enum-varnames:
        - APPLICANT_NOT_STARTED
        - APPLICANT_STARTED
        - APPLICANT_SUBMITTED
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic

````