List attachments for a transaction

OAuth scope: organization.read

Retrieves all the attachments for the transaction identified by the id path parameter.

In the Qonto app, attachments are files uploaded onto transactions by users. Attachments typically correspond to the invoice or receipt, and are used to justify the transactions from a bookkeeping standpoint.

You can retrieve the IDs of those attachments inside each transaction object, by calling GET /v2/transactions.

Probative attachment is another version of attachment, compliant with PAdES standard.

For security reasons, the url you retrieve for each attachment is only valid for 30 minutes. If you need to download the file after more than 30 minutes, you will need to perform another authenticated call in order to generate a new download URL.

If you download the file using curl, replace the \\u0026 references by & in the url string.

GET

transactions

{id}

attachments

curl --request GET \
  --url https://thirdparty.qonto.com/v2/transactions/{id}/attachments \
  --header 'Authorization: Bearer <token>'

{
  "attachments": [
    {
      "id": "9b048e2c-d546-415b-b001-d31a6d4ae1e3",
      "created_at": "2021-01-27T22:05:07.000Z",
      "file_name": "Foobar",
      "file_size": "666",
      "file_content_type": "image/png",
      "url": "https://my-s3.url.qonto.bucket.com/123456789",
      "probative_attachment": {
        "status": "available",
        "file_name": "statement.pdf",
        "file_content_type": "application/pdf",
        "file_size": "123",
        "url": "https://my-s3.url.qonto.bucket.com/123456789"
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token

string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Path Parameters

string

required

Example:

"aab86d8a-0d4c-4749-9a49-0ada88a9c423"

Query Parameters

page

string

Returned page (cf. Pagination).

per_page

string

Number of attachments per page (cf. Pagination).

Response

200

application/json

Returns the list of attachments for the transaction identified by the `id` path parameter.

The response is of type object.

Retrieve an attachment Upload an attachment to a transaction

curl --request GET \
  --url https://thirdparty.qonto.com/v2/transactions/{id}/attachments \
  --header 'Authorization: Bearer <token>'

{
  "attachments": [
    {
      "id": "9b048e2c-d546-415b-b001-d31a6d4ae1e3",
      "created_at": "2021-01-27T22:05:07.000Z",
      "file_name": "Foobar",
      "file_size": "666",
      "file_content_type": "image/png",
      "url": "https://my-s3.url.qonto.bucket.com/123456789",
      "probative_attachment": {
        "status": "available",
        "file_name": "statement.pdf",
        "file_content_type": "application/pdf",
        "file_size": "123",
        "url": "https://my-s3.url.qonto.bucket.com/123456789"
      }
    }
  ]
}