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

# Get Submission

> Returns a single bureau submission by ID. Returns 404 if the submission
does not exist or its tradeline belongs to a different partner.




## OpenAPI

````yaml GET /submissions/{id}
openapi: 3.0.3
info:
  title: Cove Data Furnishing API
  description: >
    A generic data furnishing API that accepts any recurring payment type

    (rent, child support, alimony, utilities, etc.) and reports it to credit

    bureaus (Equifax, TransUnion, Experian) in Metro 2 format.


    ## Authentication

    All requests require an `x-api-key` header with a valid API key.

    - `sk_live_*` keys operate in production mode.

    - `sk_test_*` keys operate in sandbox mode (data is created but never
    reaches bureaus).


    ## Amounts

    All monetary amounts are in **cents** (USD integers). For example, $45.00 =
    `4500`.


    ## Dates

    All date fields use `YYYY-MM-DD` format.


    ## Integration Guide

    For a full walkthrough with curl examples, see the

    [Integration Guide](./integration-guide.md).
  version: 1.0.0
  contact:
    name: Cove
    url: https://cove.dev
  license:
    name: Proprietary
    url: https://cove.dev/terms
servers:
  - url: https://vvdufluovypptsnkihyv.supabase.co/functions/v1
    description: Current deployment (Supabase)
  - url: https://furnish.cove.dev/v1
    description: Production (coming soon)
  - url: https://sandbox-furnish.cove.dev/v1
    description: Sandbox (coming soon)
security:
  - ApiKeyAuth: []
tags:
  - name: Consumers
    description: >-
      Manage consumer records (PII). Consumers represent the individuals whose
      payments are being reported to credit bureaus.
  - name: Tradelines
    description: >-
      Manage tradelines — ongoing payment obligations being reported to credit
      bureaus. Each tradeline belongs to a consumer and tracks a specific
      payment type.
  - name: Payments
    description: >-
      Report monthly payments against tradelines. Each payment automatically
      updates the tradeline's account status, balance, and 24-month payment
      history.
  - name: Submissions
    description: >-
      Track and manage bureau submission status. Submissions are created
      automatically or via manual trigger.
  - name: Webhooks
    description: Webhook event types and payloads delivered to your configured webhook URL.
paths:
  /submissions/{id}:
    get:
      tags:
        - Submissions
      summary: Get a submission
      description: |
        Returns a single bureau submission by ID. Returns 404 if the submission
        does not exist or its tradeline belongs to a different partner.
      operationId: getSubmission
      parameters:
        - $ref: '#/components/parameters/id'
      responses:
        '200':
          description: Submission details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Submission'
              example:
                id: 880e8400-e29b-41d4-a716-446655440003
                tradeline_id: 660e8400-e29b-41d4-a716-446655440001
                bureau: equifax
                metro2_file_id: null
                submission_date: '2026-02-05'
                status: accepted
                response_code: '00'
                response_message: Record accepted successfully
                error_details: null
                retry_count: 0
                created_at: '2026-02-05T06:00:00Z'
                updated_at: '2026-02-06T14:30:00Z'
        '401':
          $ref: '#/components/responses/AuthenticationError'
        '404':
          $ref: '#/components/responses/NotFoundError'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    id:
      name: id
      in: path
      required: true
      description: Resource UUID
      schema:
        type: string
        format: uuid
  schemas:
    Submission:
      type: object
      properties:
        id:
          type: string
          format: uuid
        tradeline_id:
          type: string
          format: uuid
        bureau:
          type: string
          enum:
            - equifax
            - transunion
            - experian
        metro2_file_id:
          type: string
          format: uuid
          nullable: true
        submission_date:
          type: string
          format: date
        status:
          $ref: '#/components/schemas/SubmissionStatus'
        response_code:
          type: string
          nullable: true
        response_message:
          type: string
          nullable: true
        error_details:
          type: string
          nullable: true
        retry_count:
          type: integer
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    SubmissionStatus:
      type: string
      description: Lifecycle status of a bureau submission
      enum:
        - pending
        - submitted
        - accepted
        - rejected
        - error
    Error:
      type: object
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
              enum:
                - VALIDATION_ERROR
                - AUTHENTICATION_ERROR
                - AUTHORIZATION_ERROR
                - NOT_FOUND
                - CONFLICT
                - RATE_LIMITED
                - INTERNAL_ERROR
            message:
              type: string
              description: Human-readable error description
            field:
              type: string
              description: >-
                Dot-notation path to the field that caused the error (e.g.,
                address.state). Only present when a specific field is
                responsible.
            request_id:
              type: string
              format: uuid
  responses:
    AuthenticationError:
      description: Authentication error (401)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: AUTHENTICATION_ERROR
              message: Missing x-api-key header
              request_id: 4e9024e3-125d-4d08-a392-4fa34f6bda44
    NotFoundError:
      description: Resource not found (404)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: NOT_FOUND
              message: Consumer not found
              request_id: 4e9024e3-125d-4d08-a392-4fa34f6bda44
    InternalError:
      description: Internal server error (500)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INTERNAL_ERROR
              message: An unexpected error occurred
              request_id: 4e9024e3-125d-4d08-a392-4fa34f6bda44
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >
        API key in the format `sk_live_<token>` (production) or
        `sk_test_<token>` (sandbox).

        Contact Cove to obtain your API key.

````