# Retrieve Payment Status

Retrieves status of a previously created payment. Provides insight into any actions or RFIs that require attention.

Endpoint: GET /v1/payments/{payment_id}/status
Version: 1.1.2
Security: OAuth2Flow

## Path parameters:

  - `payment_id` (string, required)
    Payment ID

## Header parameters:

  - `Authorization` (string)
    OAuth bearer token (see authentication flows)

  - `x-l2f-request-id` (string)
    Optional Unique ID per request, useful for fault resolution/diagnosis and audit.

## Response 200 fields (application/json):

  - `data` (object, required)

  - `data.id` (string, required)
    Unique ID of the payment
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `data.status` (string, required)
    Current status of the payment
    Example: "REQUESTED"

  - `data.document_errors` (array)
    List of document errors that require attention

  - `data.document_errors.document_id` (string, required)
    Unique identifier of the document
    Enum: "MISSING", "SUBMITTED", "CHANGES_REQUESTED", "REJECTED", "APPROVED"

  - `data.document_errors.document` (string, required)
    Document Type the error occurred on
    Enum: "ANNUAL_REPORT", "BENEFICIAL_OWNERSHIP_CERTIFICATE", "BILL_OF_LADING", "CONTRACT", "DRIVERS_LICENCE_BACK", "DRIVERS_LICENCE_FRONT", "FINANCIAL_STATEMENT", "GOVERNMENT_ID_BACK", "GOVERNMENT_ID_FRONT", "INCORPORATION_DOCUMENTS", "INVOICE", "LEASE_AGREEMENT", "LLC_AGREEMENT", "OWNERSHIP_STRUCTURE_CHART", "PARTNERSHIP_AGREEMENT", "PASSPORT", "POWER_OF_ATTORNEY", "REGULATORY_LICENSE", "SELFIE", "SOCIAL_SECURITY_CARD", "UTILITY_BILL"

  - `data.document_errors.status` (string, required)
    Status of the document upload
    Enum: "MISSING", "SUBMITTED", "CHANGES_REQUESTED", "REJECTED", "APPROVED"

  - `data.document_errors.mandatory` (boolean, required)
    Indicates if the document is mandatory

## Response 400 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 401 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 404 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description

## Response 500 fields (application/json):

  - `errors` (array)
    Error List

  - `errors.code` (string)
    Layer2 Standard Error Code

  - `errors.description` (string)
    Error Description