--- title: "List connection reports" method: GET path: "/connectivity/v2beta/connections/{cid}/reports" tags: ["Connections"] --- # List connection reports `GET /connectivity/v2beta/connections/{cid}/reports` ## Request - Base URL: `https://api.atlar.com` - URL: `https://api.atlar.com/connectivity/v2beta/connections/{cid}/reports` - Auth: HTTP basic - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve all connection reports. ## Path parameters - `cid` string, required ## Query parameters - `limit` integer - `token` string - `from` string, date-time - `to` string, date-time - `type` 'STATEMENT' | 'INVESTMENT' | 'ACCOUNTING' | 'FX_RATES' | 'PAYMENT_STATUS' | 'BENCHMARK_RATES' | 'INSTRUMENT_PRODUCTS' | 'ACCOUNTS' | 'OTHER': The type of the report. - `statementType` 'BOOKED' | 'PENDING' ## Response `200` List of connection reports. - object - `items` ConnectionReport[], required: A list of resources. - `organizationId` string, required: Unique resource identifier for an Organization. - `connectionId` string, required: Unique resource identifier. - `id` string, required: Unique resource identifier. - `details` ConnectionReportDetails, required - `type` 'STATEMENT' | 'INVESTMENT' | 'ACCOUNTING' | 'FX_RATES' | 'PAYMENT_STATUS' | 'BENCHMARK_RATES' | 'INSTRUMENT_PRODUCTS' | 'ACCOUNTS' | 'OTHER', required: The type of the report. - `statementType` 'BOOKED' | 'PENDING', required - `content` ContentMetadata, required: Metadata describing the contents that was retrieved over the Connection. - `contentType` 'application/vnd.iso20022.pain.001.001.03+xml' | 'application/vnd.iso20022.pain.001.001.03.ch.02+xml' | 'application/vnd.iso20022.pain.001.001.09+xml' | 'application/vnd.iso20022.pain.001.001.09.ch.03+xml' | 'application/vnd.iso20022.pain.002.001.03+xml' | 'application/vnd.iso20022.pain.002.001.10+xml' | 'application/vnd.iso20022.pain.008.001.02+xml' | 'application/vnd.iso20022.pain.008.001.02.ch.03+xml' | 'application/vnd.iso20022.pain.008.001.03+xml' | 'application/vnd.iso20022.pain.008.001.08+xml' | 'application/vnd.iso20022.camt.052.001.02+xml' | 'application/vnd.iso20022.camt.052.001.03+xml' | 'application/vnd.iso20022.camt.052.001.04+xml' | 'application/vnd.iso20022.camt.052.001.08+xml' | 'application/vnd.iso20022.camt.053.001.02+xml' | 'application/vnd.iso20022.camt.053.001.03+xml' | 'application/vnd.iso20022.camt.053.001.04+xml' | 'application/vnd.iso20022.camt.053.001.08+xml' | 'application/vnd.iso20022.camt.053.001.10+xml' | 'application/vnd.iso20022.camt.053.001.11+xml' | 'application/vnd.iso20022.camt.053.001.12+xml' | 'application/vnd.iso20022.camt.054.001.02+xml' | 'application/vnd.iso20022.pacs.002.001.10+xml' | 'application/vnd.iso20022.pacs.008.001.02+xml' | 'application/vnd.iso20022.pacs.008.001.08+xml' | 'application/vnd.swift.mt.101' | 'application/vnd.swift.mt.103' | 'application/vnd.swift.mt.900' | 'application/vnd.swift.mt.940' | 'application/vnd.swift.mt.942' | 'application/vnd.bai.bai2' | 'application/vnd.bgc.autogiro.payee' | 'application/vnd.bgc.autogiro.payments.rejected' | 'application/vnd.bgc.autogiro.payments.spec' | 'application/vnd.bgc.autogiro.mandate' | 'application/vnd.bgc.payins.bgmax' | 'application/vnd.nacha.ach' | 'application/vnd.atlar.testbank.mandate+json' | 'application/vnd.atlar.testbank.transaction+json' | 'application/vnd.atlar.connectivity.proprietary' | 'application/vnd.atlar.connectivity.proprietary+json' | 'application/vnd.atlar.connectivity.proprietary+xml' | 'application/vnd.atlar.connectivity.proprietary+csv' | 'application/vnd.atlar.connectivity.v2.investment-statement+json' | 'application/vnd.atlar.connectivity.v2.accounting-statement+json' | 'application/vnd.atlar.connectivity.v2.fx-rate-statement+json' | 'application/vnd.atlar.connectivity.v2.benchmark-rate-statement+json' | 'application/vnd.atlar.connectivity.v2.instrument-product-statement+json' | 'application/vnd.atlar.connectivity.v2.statement+json' | 'application/vnd.atlar.connectivity.v2.statement+csv' | 'application/vnd.deutsche.wealth-online+csv' | 'application/vnd.m2.m006.m001+xml' | 'application/vnd.m2.m006.m005+xml' | 'application/vnd.ebics.htd.v30+xml' | 'application/vnd.ebics.hac.v25+xml' | 'application/vnd.ebics.hac.v30+xml' | 'application/vnd.jpm.daily-feed+zip' | 'application/vnd.jpm.morgan-money.balance-report+csv' | 'application/vnd.jpm.morgan-money.transaction-report+csv' | 'application/vnd.jpm.soci.holdings+csv' | 'application/vnd.jpm.soci.transactions+csv' | 'application/vnd.jpm.soci.cash-balance+csv' | 'application/vnd.nordea.investments.abasec.pos+csv' | 'application/vnd.nordea.investments.abasec.tra+csv' | 'application/vnd.blackrock.cachematrix.balance+csv' | 'application/vnd.blackrock.cachematrix.transactions+csv' | 'application/vnd.adyen.balance-platform.statement-report+csv' | 'application/vnd.ms-excel' | 'application/x-ofx' | 'application/json' | 'application/zip' | 'application/pdf' | 'text/plain' | 'text/csv' | 'application/vnd.edi.820' | 'application/vnd.edi.824' | 'application/vnd.edi.997', required: The content type of the data. - `size` integer, required: The size of the input content in bytes. - `checksum` string, required: A checksum of the batch input contents. The checksum digest value will be prefixed by an identifier of the hash algorithm used, e.g. `sha256`. A colon `:` is used as separator between the algorithm identifier and the digest value. - `name` string, required: The name of the content that retrieved over the connection. If the connection is a file transfer, the filename will be used. If the third-party does not provide a name, Atlar will create one. - `converted` boolean, required - `thirdPartyCodes` string[]: The third parties this report holds data for. Typically, the bank BICs occurring in the report, for example an end-of-day report carrying several statements, each reporting for one BIC. Reports from parties without a BIC, such as PSPs and ERPs, use a synthetic code instead, for example `PSP_AIRWALLEX`. - `metadata` Metadata, nullable: Metadata is a `string-string` key-value container that can be used to store information known at the time of resource creation. This can be retrieved later on, for instance when a payment or expected transaction is reconciled with the booked transaction on the bank statement. Metadata can have at most 20 entries. Keys may have a maximum length of 64 chars and values a maximum length of 512 chars. By default, this field is optional. It is possible to make it required in the Atlar Dashboard by visiting the [Metadata keys page](https://app.atlar.com/metadata-keys). Requirement rules can be specified per API resource. Both the Dashboard and the API will then enforce these rules and give validation errors when the required fields are not set. - `version` integer, required: Resource version. Starts at value `1` when the resource is created and increases by one for each successive update. - `etag` string, required: [ETag](https://en.wikipedia.org/wiki/HTTP_ETag) based on the resource version. This can be passed along in `If-Match` HTTP header when updating a resource to perform a conditional update. - `created` string, date-time, required: Time at which the resource was created. - `updated` string, date-time, required: Time at which the resource was last updated. - `nextToken` string, required: Pagination token for next page. The value will be a non-empty string if there are more resources to be fetched. The value will be an empty string if there are no more resources to be fetched. - `token` string, required: The pagination token that was used for this request. The value will be an empty string if no `token` query parameter was provided with the request. - `limit` integer, required: The page limit that was used for this request. ## Other responses - `400`: Bad request. ## Changes - **2026-11-03** `b49df1e4b3e9`: 1 breaking, 25 warning, 10 info - added `#/components/schemas/ConnectionReportStatementDetails` to the `allOf[subschema #2]/items/items/details` response property `oneOf` list for the response status `200` - added the new `application/pdf` enum value to the `allOf[subschema #2]/items/items/content/contentType` response property for the response status `200` - added the new `application/vnd.adyen.balance-platform.statement-report+csv` enum value to the `allOf[subschema #2]/items/items/content/contentType` response property for the response status `200` - added the new `application/vnd.atlar.connectivity.v2.instrument-product-statement+json` enum value to the `allOf[subschema #2]/items/items/content/contentType` response property for the response status `200` - …32 more [Operation history](https://skmtc.dev/atlar/apis/atlar-api-v2/changes/connectivity/v2beta/connections/:cid/reports/get.md) --- [API](https://skmtc.dev/atlar/apis/atlar-api-v2.md) - [All operations](https://skmtc.dev/atlar/apis/atlar-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/atlar/apis/atlar-api-v2/revisions/b49df1e4b3e9?raw)