---
title: "Fetch details of a submission"
method: GET
path: "/submission/{submission-id}"
tags: ["get submission", "query"]
---

# Fetch details of a submission

`GET /submission/{submission-id}`

## Request

- Base URL: `/efs-submissions-api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/efs-submissions-api/submission/{submission-id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/companies-house/apis/emergency-filing-service-api/docs/submission/:submission-id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

Submission details

- Submission
  - `id` string, required: Unique identifer of a submission
  - `confirmation_reference` string, required: user-friendly reference for confirmation screen and email
  - `created_at` string, date-time, required: Date and time the submission was created
  - `submitted_at` string, date-time: Date and time the submission was submitted
  - `last_modified_at` string, date-time, required: Date and time the submission was last updated
  - `presenter` Presenter, required: Person making the application
    - `email` string, email, required: email address
  - `company` Company, required: Company number and name
    - `company_name` string, required: Existing or proposed company name
    - `company_number` string, required: Existing company number
  - `payment_sessions` PaymentSession[]: Collection of associated payment session details
    - `session_id` string, required
    - `session_state` string, Base64 encoded, required: secure random nonce
    - `session_status` 'Paid' | 'Pending' | 'Failed', required: Provisional payment session status
  - `fee_on_submission` string: fee amount at time submission was made
  - `status` 'OPEN' | 'SUBMITTED' | 'REJECTED_BY_VIRUS_SCAN' | 'PROCESSED_BY_EMAIL' | 'PROCESSING' | 'REJECTED_BY_DOCUMENT_CONVERTER' | 'READY_TO_SUBMIT' | 'SENT_TO_FES' | 'ACCEPTED' | 'REJECTED', required
  - `form` object, required: Form details
    - `barcode` string: Barcode required for FES
    - `form_type` string: Type of form
    - `file_details` object[]
      - `file_id` string: File identifier
      - `file_name` string: File name
      - `file_size` number: File size
      - `converted_file_id` string: Converted file identifier
      - `conversion_status` 'WAITING' | 'CLEAN_AV' | 'FAILED_AV' | 'QUEUED' | 'CONVERTED' | 'FAILED'
      - `number_of_pages` number: Number of pages in the converted file
      - `last_modified_at` string, date-time: Date and time the submission was last updated
  - `reject_reasons` object[]
    - `reason` string: Reject reason recorded in CHIPS

## Other responses

- `400`: Incomplete or malformed request
- `401`: Invalid or missing credentials
- `404`: Requested resource was not found

---

[API](https://skmtc.dev/companies-house/apis/emergency-filing-service-api.md) - [All operations](https://skmtc.dev/companies-house/apis/emergency-filing-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companies-house/apis/emergency-filing-service-api/revisions/7dbd2ded46b4?raw)