New report

This endpoint requires the reports.write scope.

Authorizations

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name

string

required

The name of the report.

description

string | null

The description of the report.

schedule

enum<string>

default: once

Specifies the schedule of the report.

If this is a one-off report, set this value to once.

If this is a recurring report, this value should be set to the frequency by which the report will be executed. For example, a monthly schedule means that the report will be periodically executed at the start of each month.

Note that a weekly schedule means that the report will be executed at the start of every Monday.

Available options:

daily,

monthly,

once,

weekly

schedule_enabled

boolean | null

Indicates whether the report's scheduling is enabled. This value can only be set to true if this is a recurring report.

If this value is set to true, the report will be executed at the next_execution_at date and time.

If this is a recurring report and this value is set to false, executions of the report will not occur until this value is set to true.

If this value is not provided, schedule_enabled will automatically be set to false if schedule is once and set to true otherwise.

schedule_timezone

string

default: Etc/UTC

The time zone in which the report's executions will be scheduled. This value is used to compute the report's next_execution_at value and is only relevant when this is a recurring report. This time zone is also used to calculate the timestamp range for reports that use date-time placeholders. Date-time placeholders are dynamic timestamps that change with every report execution.

This value must be set to the time zone's name as presented in the IANA time zone database. For example, to schedule reports in the time zone of New York, set this value to America/New_York.

spec

object

required

The specifications of the report.

spec.model

enum<string>

required

The model (dataset) that the data used for the report is retrieved from.

Available options:

transactions

spec.params

object

required

Parameters used to configure the report. Acceptable values for this property depend on the value specified for model.

spec.params.fields

enum<string>[]

A list of fields for the report.

Available options:

id,

external_identifier,

status,

created_at,

updated_at,

authorized_at,

captured_at,

voided_at,

amount,

currency,

captured_amount,

refunded_amount,

method,

scheme,

payment_service_transaction_id,

payment_service_id,

payment_service_definition_id,

payment_service_display_name,

auth_response_code,

raw_response_code,

raw_response_description,

metadata,

is_subsequent_payment,

merchant_initiated,

payment_source,

three_d_secure_status,

three_d_secure_eci,

three_d_secure_auth_resp,

three_d_secure_method,

buyer_external_identifier,

billing_details_first_name,

billing_details_last_name,

billing_details_email_address,

billing_details_phone_number,

billing_details_address_city,

billing_details_address_country,

billing_details_address_postal_code,

billing_details_address_state,

billing_details_address_state_code,

billing_details_address_house_number_or_name,

billing_details_address_line1,

billing_details_address_line2,

billing_details_address_organization,

billing_details_tax_id,

billing_details_tax_id_kind

spec.params.filters

object

The filters for the report.

spec.params.sort

object[]

A list of fields to sort the report.

Response

201 - application/json

type

enum<string>

The type of this resource. Is always report.

Available options:

report

string

The unique identifier for this report.

merchant_account_id

string

The unique ID for a merchant account.

name

string

The name of this report.

creator_id

string | null

The unique identifier for the creator of this report.

creator_display_name

string | null

The name of the creator of this report.

creator_type

enum<string> | null

The type of the creator of this report.

Available options:

user,

private_key

created_at

string

The date and time this report was created in our system.

updated_at

string

The date and time this report was last updated.

next_execution_at

string | null

The date and time this report will next be executed, provided that schedule_enabled is true. This value is null if this is a one-off report.

description

string | null

The description of this report.

schedule

enum<string>

Specifies the schedule of this report.

If this is a one-off report, this value is once.

If this is a recurring report, this value is set to the frequency by which the report will be executed. For example, a monthly schedule means that this report will be periodically executed at the start of each month.

Note that a weekly schedule means that the report is executed at the start of every Monday.

Available options:

daily,

monthly,

once,

weekly

schedule_enabled

boolean

Indicates whether this report's scheduling is enabled. This value can only be set to true if this is a recurring report.

When this value is set to true, this report will be executed at the next_execution_at date and time.

When this value is set to false, future executions of this report are paused until this value is set to true again.

schedule_timezone

string

The time zone in which the next execution will be scheduled. This value is used to calculate this report's next_execution_at value and is only relevant if this is a recurring report. This time zone is also used to calculate the timestamp range for reports that use date-time placeholders. Date-time placeholders are dynamic timestamps that change with every report execution.

spec

object

The specifications of this report.

spec.model

enum<string>

required

The model (dataset) that the data used for the report is retrieved from.

Available options:

transactions

spec.params

object

required

Parameters used to configure the report. Acceptable values for this property depend on the value specified for model.

spec.params.fields

enum<string>[]

A list of fields for the report.

Available options:

id,

external_identifier,

status,

created_at,

updated_at,

authorized_at,

captured_at,

voided_at,

amount,

currency,

captured_amount,

refunded_amount,

method,

scheme,

payment_service_transaction_id,

payment_service_id,

payment_service_definition_id,

payment_service_display_name,

auth_response_code,

raw_response_code,

raw_response_description,

metadata,

is_subsequent_payment,

merchant_initiated,

payment_source,

three_d_secure_status,

three_d_secure_eci,

three_d_secure_auth_resp,

three_d_secure_method,

buyer_external_identifier,

billing_details_first_name,

billing_details_last_name,

billing_details_email_address,

billing_details_phone_number,

billing_details_address_city,

billing_details_address_country,

billing_details_address_postal_code,

billing_details_address_state,

billing_details_address_state_code,

billing_details_address_house_number_or_name,

billing_details_address_line1,

billing_details_address_line2,

billing_details_address_organization,

billing_details_tax_id,

billing_details_tax_id_kind

spec.params.filters

object

The filters for the report.

spec.params.sort

object[]

A list of fields to sort the report.

latest_execution

object

Details of the latest execution of this report.

Payments

Instruments

Vault

Connections

Dashboard

Errors

Authorizations

Body

Response