---
title: "Statement Initiation Request"
method: POST
path: "/statement/initiation"
tags: ["Statement Services v1"]
---

# Statement Initiation Request

`POST /statement/initiation`

## Request

- Base URL: `https://tts.apib2b.citi.com/citiconnect/prod/accountstatementservices/v1`
- URL: `https://tts.apib2b.citi.com/citiconnect/prod/accountstatementservices/v1/statement/initiation`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/authenticationservices/v1/oauth/token`
- TypeScript: <https://skmtc.dev/citi/apis/statement-services/docs/statement/initiation/post.ts> (a function with typed inputs; its response is checked against the schema)

The Statement Initiation endpoint follows a custom XML format. The response from this endpoint returns a ``statementId``. This identifier must then be used in the retrieval request.

**Note:** Statement initiation requires some time to be processed to allow successful retrieval. It will depend on the statement size – best practice is to set the retrieval interval every 15 seconds until you receive a 200 successful response. It may take from 15 seconds to a few minutes before the statement is generated.

## Query parameters

- `client_id` string, required

## Headers

- `Content-Type` string, required
- `Timezone` string
- `Attachment-Encoding` string

## Request body `application/xml`

- StatementInitiationRequest
  - `accountNumber` string[], required: The account number(s) for which the account statement is to be retrieved. You can specify multiple accounts by using multiple account objects. If no value is sent the Statements API will send a reject response with an error message.
  - `formatName` 'SWIFT_MT940' | 'CAMT_053_001_02' | 'SWIFT MT942' | 'CAMT_052_001_02', required: Specifies the format of the statement(s) to be generated. Valid values include: * SWIFT_MT940 * CAMT_053_001_02 * SWIFT MT942 * CAMT_052_001_02 **Note:** ``formatName`` will be ignored if ``templateName`` is supplied, but ``formatName`` is still required for completeness.
  - `fromDate` string, YYYY-MM-DD, required: Specifies the beginning date for the statement request. ``fromDate`` uses _YYYY-MM-DD_ format.
  - `toDate` string, YYYY-MM-DD, required: Specifies the ending date for the statement request. ``fromDate`` uses _YYYY-MM-DD_ format.
  - `templateName` string: The template name, as defined in CitiDirect BE File Services (STR Library Number). Before you make your first statement API request, make sure that the correct template (also known as an "export profile") has been set up using CitiDirect BE. For help setting up a template contact your Citi representative. The template contains the following: * the format standard * the list of transaction codes and descriptions * the display of itemized entries for bulk debits * the list of the date and time stamps You can choose between: * Detailed itemized entries - list all transactions on the statement. If you would like an itemized Statement Retrieval (STR), please contact your Citi representative to perform the setup on your behalf. You must then use the STR library Name in your statement initiation request. * A single consolidated debit entry - one debit entry that can contain several smaller transactions. These are also known as bulk debit transactions. When creating the template, the time zone where the template is initially set up will be used when generating the account statement as well as the frequency and interval specified.
  - `strLibrayName` string: Specifies the STR Library name created as part of STR profile by the Citi representative, if itemization data is required.
  - `baiCode` string: Transaction classification code indicating the type of financial transaction.

## Response `200`

OK

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/citi/apis/statement-services.md) - [All operations](https://skmtc.dev/citi/apis/statement-services/llms.txt) - [OpenAPI document](https://skmtc.dev/citi/apis/statement-services/revisions/676a9e432f1f?raw)