---
title: "Process SPP request"
method: POST
path: "/spp"
---

# Process SPP request

`POST /spp`

## Request

- The document declares no server URL.
- Auth: none declared

Convert a survey response into an SPP file

## Query parameters

- `survey_id` string, required
- `period_id` string, required
- `ru_ref` string, required
- `form_type` string, required
- `period_start_date` string, required
- `period_end_date` string, required
- `data_version` string

## Request body

- union
  - ListCollector
    - `answer_codes` AnswerCode[]
      - `answer_id` string
      - `code` string
      - `answer_value` string, nullable
    - `answers` Answer[]
      - `answer_id` string
      - `value` union
        - object
        - string
      - `list_item_id` string, nullable
    - `lists` Group[]
      - `items` string[]
      - `name` string
      - `supplementary_data_mappings` SupplementaryDataMapping[], nullable
        - `identifier` string
        - `list_item_id` string
  - Data

## Response `200`

Successful response

- SPP
  - `formtype` string
  - `reference` string
  - `period` string
  - `survey` string
  - `responses` SPPResponse[]
    - `questioncode` string
    - `response` string
    - `instance` integer

## Other responses

- `400`: Bad request
- `500`: Internal server error

## Changes

- **2025-04-02** `1b7db3be203d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/office-of-national-statistics/apis/sdx-transformer-api/changes/spp/post.md)

---

[API](https://skmtc.dev/office-of-national-statistics/apis/sdx-transformer-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/sdx-transformer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/sdx-transformer-api/revisions/1b7db3be203d?raw)