Skip to content
Reporting / Reports API

Reports API Beta

Last updated: 17th August 2022

You can use our Reports API to retrieve the following reconciliation reports:

To learn more, reach out to your Customer Success Manager or support@checkout.com.

Authentication

Requests to the /reports endpoint must be authenticated by providing your Access key (OAuth 2.0) or API key in the request's Authorization header.

1
--header 'Authorization: Bearer <token>'

Retrieve all reports

Use this endpoint to access all of your reports.

You can also use the following optional query parameters to filter and refine your search query:

ParameterDescription

created_after

Filters reports to those that were created on or after the specified date. The date should be provided in the format: YYYY-MM-DD.

created_before

Filters reports to those that were created before the specified date. The date should be provided in the format: YYYY-MM-DD.

entity_id

Filters reports to those that match the specified client entity ID. Sub-entity IDs are not supported.

limit

The number of results to retrieve per page. The maximum value is 100. If no value is specified, this is used by default.

If the value provided is lower than the total number of results, you'll need to send the response's _links.next.href URL in a query to retrieve the next page of results.

Endpoints

For the full API specification, see the API reference.

    get

    https://api.checkout.com/reports

    Request example

    1
    2
    curl --location --request GET 'https://api.sandbox.checkout.com/reports?limit=1&created_after=2022-02-14&created_before=2022-02-16&entity_id=ent_zxmc2csd961nfd2mcwzkvdgmpb' \
    --header 'Authorization: Bearer sk_sbox_wjvrysklsqjmrhn3yoexnshsl72'

    Response example

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    {
        "count": 1,
        "limit": 1,
        "data": [
            {
                "id": "rpt_x",
                "created_on": "2022-02-15T02:31:12.357+00:00",
                "type": "FinancialActions",
                "description": "Financial Actions by Date Range",
                "account": {
                    "client_id": "cli_123",
                    "entity_id": "ent_zxmc2csd961nfd2mcwzkvdgmpb"
                },
                "tags": [],
                "from": "2022-02-14T00:00:00",
                "to": "2022-02-15T00:00:00",
                "files": [
                    {
                        "id": "file_y",
                        "filename": "financialactions_ent_zxmc2csd961nfd2mcwzkvdgmpb_20220214_20220215_1.csv",
                        "format": "CSV",
                        "_links": {
                            "self": {
                                "href": "https://api.sandbox.checkout.com/reports/rpt_x/files/file_y"
                            }
                        }
                    }
                ],
                "_links": {
                    "self": {
                        "href": "https://api.sandbox.checkout.com/reports/rpt_x"
                    }
                }
            }
        ],
        "_links": {
            "self": {
                "href": "https://api.sandbox.checkout.com/reports?limit=1&created_after=2022-02-14&created_before=2022-02-16&entity_id=ent_zxmc2csd961nfd2mcwzkvdgmpb"
            },
            "next": {
                "href": "https://api.sandbox.checkout.com/reports?pagination_token=1644892272357&limit=1&created_after=2022-02-14&created_before=2022-02-16&entity_id=ent_zxmc2csd961nfd2mcwzkvdgmpb"
            }
        }
    }

    If the results for a query are split across multiple pages, the response returns a URL in the _links.next.href field. You can use this URL in a query to retrieve the next page of results.

    Subsequent responses will also include this field, until all results have been returned.

    Retrieve a specific report

    Use this endpoint to retrieve a specific report, using its ID.

    You can find a report's ID in the response you receive when you perform a request to retrieve all reports, in its respective data.id field.

    Endpoints

    For the full API specification, see the API reference.

      get

      https://api.checkout.com/reports/{reportId}

      Request example

      1
      2
      curl --location --request GET 'https://api.sandbox.checkout.com/reports/rpt_x' \
      --header 'Authorization: Bearer sk_sbox_wjvrysklsqjmrhn3yoexnshsl72'

      Response example

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      {
          "id": "rpt_x",
          "created_on": "2022-02-15T02:31:12.357+00:00",
          "type": "FinancialActions",
          "description": "Financial Actions by Date Range",
          "account": {},
          "tags": [],
          "from": "2022-02-14T00:00:00",
          "to": "2022-02-15T00:00:00",
          "files": [
              {
                  "id": "file_y",
                  "filename": "financialactions_ent_zxmc2csd961nfd2mcwzkvdgmpb_20220214_20220215_1.csv",
                  "format": "CSV",
                  "_links": {
                      "self": {
                          "href": "https://api.sandbox.checkout.com/reports/rpt_x/files/file_y"
                      }
                  }
              }
          ],
          "_links": {
              "self": {
                  "href": "https://api.sandbox.checkout.com/reports/rpt_x"
              }
          }
      }

      Retrieve a file from a report

      Use this endpoint to retrieve a specific file from a report, using its ID.

      You can find a file's ID in the response you receive when you perform a request to retrieve your reports, in its respective files.id field.

      Endpoints

      For the full API specification, see the API reference.

        get

        https://api.checkout.com/reports/{reportId}/files/{fileId}

        Request example

        1
        2
        curl --location --request GET 'https://api.sandbox.checkout.com/reports/rpt_x/files/file_y' \
        --header 'Authorization: Bearer sk_sbox_wjvrysklsqjmrhn3yoexnshsl72'

        Response example

        Sending the request will trigger a download of the specified file, with no additional response.

        On this page

        Authentication
        Retrieve all reports
        Retrieve a specific report
        Retrieve a file from a report