Skip to main content

Paypal-Transaction full reference

This is the full reference documentation for the Paypal-Transaction agent connector.

Supported entities and actions

The Paypal-Transaction connector supports the following entities and actions.

EntityActions
BalancesList, Search
TransactionsList, Search
List PaymentsList, Search
List DisputesList, Search
List ProductsList, Search
Show Product DetailsGet, Search
Search InvoicesList, Search

Balances

Balances List

List all balances for a PayPal account. Specify date time to list balances for that time. It takes a maximum of three hours for balances to appear. Lists balances up to the previous three years.

Python SDK

await paypal_transaction.balances.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "balances",
"action": "list"
}'

Parameters

Parameter NameTypeRequiredDescription
as_of_timestringNoList balances at the date time provided in ISO 8601 format. Returns the last refreshed balance when not provided.
currency_codestringNoThree-character ISO-4217 currency code to filter balances.
Response Schema

Records

Field NameTypeDescription
balancesarray<object>
balances[].primaryboolean
balances[].currencystring
balances[].total_balanceobject
balances[].total_balance.currency_codestring
balances[].total_balance.valuestring
balances[].available_balanceobject
balances[].available_balance.currency_codestring
balances[].available_balance.valuestring
balances[].withheld_balanceobject
balances[].withheld_balance.currency_codestring
balances[].withheld_balance.valuestring
account_idstring
as_of_timestring
last_refresh_timestring

Search and filter balances records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await paypal_transaction.balances.search(
query={"filter": {"eq": {"account_id": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "balances",
"action": "search",
"params": {
"query": {"filter": {"eq": {"account_id": "<str>"}}}
}
}'

Parameters

Parameter NameTypeRequiredDescription
queryobjectYesFilter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
query.filterobjectNoFilter conditions
query.sortarrayNoSort conditions
limitintegerNoMaximum results to return (default 1000)
cursorstringNoPagination cursor from previous response's meta.cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
account_idstringThe unique identifier of the account.
as_of_timestringThe timestamp when the balances data was reported.
balancesarrayObject containing information about the account balances.
last_refresh_timestringThe timestamp when the balances data was last refreshed.
Response Schema
Field NameTypeDescription
dataarrayList of matching records
metaobjectPagination metadata
meta.has_morebooleanWhether additional pages are available
meta.cursorstring | nullCursor for next page of results
meta.took_msnumber | nullQuery execution time in milliseconds
data[].account_idstringThe unique identifier of the account.
data[].as_of_timestringThe timestamp when the balances data was reported.
data[].balancesarrayObject containing information about the account balances.
data[].last_refresh_timestringThe timestamp when the balances data was last refreshed.

Transactions

Transactions List

Lists transactions for a PayPal account. Specify one or more query parameters to filter the transactions. Requires start_date and end_date parameters. The maximum supported date range is 31 days. It takes a maximum of three hours for executed transactions to appear.

Python SDK

await paypal_transaction.transactions.list(
start_date="<str>",
end_date="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "transactions",
"action": "list",
"params": {
"start_date": "<str>",
"end_date": "<str>"
}
}'

Parameters

Parameter NameTypeRequiredDescription
start_datestringYesStart date and time in ISO 8601 format. Seconds are required.
end_datestringYesEnd date and time in ISO 8601 format. Seconds are required. Maximum supported range is 31 days.
transaction_idstringNoFilters by PayPal transaction ID (17-19 characters).
transaction_typestringNoFilters by PayPal transaction event code.
transaction_status"D" | "P" | "S" | "V"NoFilters by PayPal transaction status code. D=Denied, P=Pending, S=Successful, V=Reversed.
transaction_currencystringNoThree-character ISO-4217 currency code.
fieldsstringNoFields to include in the response. Comma-separated list. Use 'all' to include all fields. Default is transaction_info.
page_sizeintegerNoNumber of items per page (1-500).
pageintegerNoPage number to return.
balance_affecting_records_only"Y" | "N"NoY to include only balance-impacting transactions (default). N to include all transactions.
Response Schema

Records

Field NameTypeDescription
transaction_infoobject
transaction_info.paypal_account_idstring
transaction_info.transaction_idstring
transaction_info.paypal_reference_idstring
transaction_info.paypal_reference_id_typestring
transaction_info.transaction_event_codestring
transaction_info.transaction_initiation_datestring
transaction_info.transaction_updated_datestring
transaction_info.transaction_amountobject
transaction_info.transaction_amount.currency_codestring
transaction_info.transaction_amount.valuestring
transaction_info.fee_amountobject
transaction_info.fee_amount.currency_codestring
transaction_info.fee_amount.valuestring
transaction_info.insurance_amountobject
transaction_info.insurance_amount.currency_codestring
transaction_info.insurance_amount.valuestring
transaction_info.shipping_amountobject
transaction_info.shipping_amount.currency_codestring
transaction_info.shipping_amount.valuestring
transaction_info.shipping_discount_amountobject
transaction_info.shipping_discount_amount.currency_codestring
transaction_info.shipping_discount_amount.valuestring
transaction_info.transaction_statusstring
transaction_info.transaction_subjectstring
transaction_info.transaction_notestring
transaction_info.invoice_idstring
transaction_info.custom_fieldstring
transaction_info.protection_eligibilitystring
payer_infoobject
payer_info.account_idstring
payer_info.email_addressstring
payer_info.address_statusstring
payer_info.payer_statusstring
payer_info.payer_nameobject
payer_info.payer_name.given_namestring
payer_info.payer_name.surnamestring
payer_info.payer_name.alternate_full_namestring
payer_info.country_codestring
shipping_infoobject
shipping_info.namestring
shipping_info.addressobject
shipping_info.address.line1string
shipping_info.address.line2string
shipping_info.address.citystring
shipping_info.address.country_codestring
shipping_info.address.postal_codestring
cart_infoobject
cart_info.item_detailsarray<object>
cart_info.item_details[].item_codestring
cart_info.item_details[].item_namestring
cart_info.item_details[].item_descriptionstring
cart_info.item_details[].item_quantitystring
cart_info.item_details[].item_unit_priceobject
cart_info.item_details[].item_unit_price.currency_codestring
cart_info.item_details[].item_unit_price.valuestring
cart_info.item_details[].item_amountobject
cart_info.item_details[].item_amount.currency_codestring
cart_info.item_details[].item_amount.valuestring
cart_info.item_details[].total_item_amountobject
cart_info.item_details[].total_item_amount.currency_codestring
cart_info.item_details[].total_item_amount.valuestring
cart_info.item_details[].tax_amountsarray<object>
cart_info.item_details[].invoice_numberstring
cart_info.tax_inclusiveboolean
cart_info.paypal_invoice_idstring
auction_infoobject
auction_info.auction_sitestring
auction_info.auction_item_sitestring
auction_info.auction_buyer_idstring
auction_info.auction_closing_datestring
incentive_infoobject
incentive_info.incentive_detailsarray<object>
incentive_info.incentive_details[].incentive_typestring
incentive_info.incentive_details[].incentive_codestring
incentive_info.incentive_details[].incentive_amountobject
incentive_info.incentive_details[].incentive_amount.currency_codestring
incentive_info.incentive_details[].incentive_amount.valuestring
incentive_info.incentive_details[].incentive_program_codestring
store_infoobject
store_info.store_idstring
store_info.terminal_idstring
transaction_idstring
transaction_updated_datestring

Meta

Field NameTypeDescription
total_itemsinteger
total_pagesinteger
pageinteger

Search and filter transactions records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await paypal_transaction.transactions.search(
query={"filter": {"eq": {"auction_info": {}}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "transactions",
"action": "search",
"params": {
"query": {"filter": {"eq": {"auction_info": {}}}}
}
}'

Parameters

Parameter NameTypeRequiredDescription
queryobjectYesFilter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
query.filterobjectNoFilter conditions
query.sortarrayNoSort conditions
limitintegerNoMaximum results to return (default 1000)
cursorstringNoPagination cursor from previous response's meta.cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
auction_infoobjectInformation related to an auction
cart_infoobjectDetails of items in the cart
incentive_infoobjectDetails of any incentives applied
payer_infoobjectInformation about the payer
shipping_infoobjectShipping information
store_infoobjectInformation about the store
transaction_idstringUnique ID of the transaction
transaction_infoobjectDetailed information about the transaction
transaction_initiation_datestringDate and time when the transaction was initiated
transaction_updated_datestringDate and time when the transaction was last updated
Response Schema
Field NameTypeDescription
dataarrayList of matching records
metaobjectPagination metadata
meta.has_morebooleanWhether additional pages are available
meta.cursorstring | nullCursor for next page of results
meta.took_msnumber | nullQuery execution time in milliseconds
data[].auction_infoobjectInformation related to an auction
data[].cart_infoobjectDetails of items in the cart
data[].incentive_infoobjectDetails of any incentives applied
data[].payer_infoobjectInformation about the payer
data[].shipping_infoobjectShipping information
data[].store_infoobjectInformation about the store
data[].transaction_idstringUnique ID of the transaction
data[].transaction_infoobjectDetailed information about the transaction
data[].transaction_initiation_datestringDate and time when the transaction was initiated
data[].transaction_updated_datestringDate and time when the transaction was last updated

List Payments

List Payments List

Lists payments for the PayPal account. Supports filtering by start and end times.

Python SDK

await paypal_transaction.list_payments.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "list_payments",
"action": "list"
}'

Parameters

Parameter NameTypeRequiredDescription
start_timestringNoStart time in ISO 8601 format.
end_timestringNoEnd time in ISO 8601 format.
countintegerNoNumber of items per page (max 20).
start_idstringNoStarting resource ID for pagination.
Response Schema

Records

Field NameTypeDescription
idstring
intentstring
statestring
cartstring
payerobject
transactionsarray<object>
create_timestring
update_timestring
linksarray<object>

Search and filter list payments records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await paypal_transaction.list_payments.search(
query={"filter": {"eq": {"cart": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "list_payments",
"action": "search",
"params": {
"query": {"filter": {"eq": {"cart": "<str>"}}}
}
}'

Parameters

Parameter NameTypeRequiredDescription
queryobjectYesFilter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
query.filterobjectNoFilter conditions
query.sortarrayNoSort conditions
limitintegerNoMaximum results to return (default 1000)
cursorstringNoPagination cursor from previous response's meta.cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
cartstringDetails of the cart associated with the payment.
create_timestringThe date and time when the payment was created.
idstringUnique identifier for the payment.
intentstringThe intention or purpose behind the payment.
linksarrayCollection of links related to the payment
payerobjectDetails of the payer who made the payment
statestringThe state of the payment.
transactionsarrayList of transactions associated with the payment
update_timestringThe date and time when the payment was last updated.
Response Schema
Field NameTypeDescription
dataarrayList of matching records
metaobjectPagination metadata
meta.has_morebooleanWhether additional pages are available
meta.cursorstring | nullCursor for next page of results
meta.took_msnumber | nullQuery execution time in milliseconds
data[].cartstringDetails of the cart associated with the payment.
data[].create_timestringThe date and time when the payment was created.
data[].idstringUnique identifier for the payment.
data[].intentstringThe intention or purpose behind the payment.
data[].linksarrayCollection of links related to the payment
data[].payerobjectDetails of the payer who made the payment
data[].statestringThe state of the payment.
data[].transactionsarrayList of transactions associated with the payment
data[].update_timestringThe date and time when the payment was last updated.

List Disputes

List Disputes List

Lists disputes for the PayPal account. Supports filtering by update time range.

Python SDK

await paypal_transaction.list_disputes.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "list_disputes",
"action": "list"
}'

Parameters

Parameter NameTypeRequiredDescription
update_time_afterstringNoFilter disputes updated after this time in ISO 8601 format.
update_time_beforestringNoFilter disputes updated before this time in ISO 8601 format.
page_sizeintegerNoNumber of items per page (max 50).
next_page_tokenstringNoToken for retrieving the next page of results.
Response Schema

Records

Field NameTypeDescription
dispute_idstring
create_timestring
update_timestring
statusstring
reasonstring
dispute_statestring
dispute_life_cycle_stagestring
dispute_channelstring
dispute_amountobject
dispute_amount.currency_codestring
dispute_amount.valuestring
outcomestring
disputed_transactionsarray<object>
linksarray<object>

Search and filter list disputes records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await paypal_transaction.list_disputes.search(
query={"filter": {"eq": {"create_time": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "list_disputes",
"action": "search",
"params": {
"query": {"filter": {"eq": {"create_time": "<str>"}}}
}
}'

Parameters

Parameter NameTypeRequiredDescription
queryobjectYesFilter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
query.filterobjectNoFilter conditions
query.sortarrayNoSort conditions
limitintegerNoMaximum results to return (default 1000)
cursorstringNoPagination cursor from previous response's meta.cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
create_timestringThe timestamp when the dispute was created.
dispute_amountobjectDetails about the disputed amount.
dispute_channelstringThe channel through which the dispute was initiated.
dispute_idstringThe unique identifier for the dispute.
dispute_life_cycle_stagestringThe stage in the life cycle of the dispute.
dispute_statestringThe current state of the dispute.
disputed_transactionsarrayDetails of transactions involved in the dispute.
linksarrayLinks related to the dispute.
outcomestringThe outcome of the dispute resolution.
reasonstringThe reason for the dispute.
statusstringThe current status of the dispute.
update_timestringThe timestamp when the dispute was last updated.
updated_time_cutstringThe cut-off timestamp for the last update.
Response Schema
Field NameTypeDescription
dataarrayList of matching records
metaobjectPagination metadata
meta.has_morebooleanWhether additional pages are available
meta.cursorstring | nullCursor for next page of results
meta.took_msnumber | nullQuery execution time in milliseconds
data[].create_timestringThe timestamp when the dispute was created.
data[].dispute_amountobjectDetails about the disputed amount.
data[].dispute_channelstringThe channel through which the dispute was initiated.
data[].dispute_idstringThe unique identifier for the dispute.
data[].dispute_life_cycle_stagestringThe stage in the life cycle of the dispute.
data[].dispute_statestringThe current state of the dispute.
data[].disputed_transactionsarrayDetails of transactions involved in the dispute.
data[].linksarrayLinks related to the dispute.
data[].outcomestringThe outcome of the dispute resolution.
data[].reasonstringThe reason for the dispute.
data[].statusstringThe current status of the dispute.
data[].update_timestringThe timestamp when the dispute was last updated.
data[].updated_time_cutstringThe cut-off timestamp for the last update.

List Products

List Products List

Lists all catalog products for the PayPal account.

Python SDK

await paypal_transaction.list_products.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "list_products",
"action": "list"
}'

Parameters

Parameter NameTypeRequiredDescription
page_sizeintegerNoNumber of items per page (max 20).
pageintegerNoPage number starting from 1.
Response Schema

Records

Field NameTypeDescription
idstring
namestring
descriptionstring
create_timestring
linksarray<object>

Search and filter list products records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await paypal_transaction.list_products.search(
query={"filter": {"eq": {"create_time": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "list_products",
"action": "search",
"params": {
"query": {"filter": {"eq": {"create_time": "<str>"}}}
}
}'

Parameters

Parameter NameTypeRequiredDescription
queryobjectYesFilter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
query.filterobjectNoFilter conditions
query.sortarrayNoSort conditions
limitintegerNoMaximum results to return (default 1000)
cursorstringNoPagination cursor from previous response's meta.cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
create_timestringThe time when the product was created
descriptionstringDetailed information or features of the product
idstringUnique identifier for the product
linksarrayList of links related to the fetched products.
namestringThe name or title of the product
Response Schema
Field NameTypeDescription
dataarrayList of matching records
metaobjectPagination metadata
meta.has_morebooleanWhether additional pages are available
meta.cursorstring | nullCursor for next page of results
meta.took_msnumber | nullQuery execution time in milliseconds
data[].create_timestringThe time when the product was created
data[].descriptionstringDetailed information or features of the product
data[].idstringUnique identifier for the product
data[].linksarrayList of links related to the fetched products.
data[].namestringThe name or title of the product

Show Product Details

Show Product Details Get

Shows details for a catalog product by ID.

Python SDK

await paypal_transaction.show_product_details.get(
id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "show_product_details",
"action": "get",
"params": {
"id": "<str>"
}
}'

Parameters

Parameter NameTypeRequiredDescription
idstringYesProduct ID.
Response Schema

Records

Field NameTypeDescription
idstring
namestring
descriptionstring
typestring
categorystring
image_urlstring
home_urlstring
create_timestring
update_timestring
linksarray<object>

Search and filter show product details records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await paypal_transaction.show_product_details.search(
query={"filter": {"eq": {"category": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "show_product_details",
"action": "search",
"params": {
"query": {"filter": {"eq": {"category": "<str>"}}}
}
}'

Parameters

Parameter NameTypeRequiredDescription
queryobjectYesFilter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
query.filterobjectNoFilter conditions
query.sortarrayNoSort conditions
limitintegerNoMaximum results to return (default 1000)
cursorstringNoPagination cursor from previous response's meta.cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
categorystringThe category to which the product belongs
create_timestringThe date and time when the product was created
descriptionstringThe detailed description of the product
home_urlstringThe URL for the home page of the product
idstringThe unique identifier for the product
image_urlstringThe URL to the image representing the product
linksarrayContains links related to the product details.
namestringThe name of the product
typestringThe type or category of the product
update_timestringThe date and time when the product was last updated
Response Schema
Field NameTypeDescription
dataarrayList of matching records
metaobjectPagination metadata
meta.has_morebooleanWhether additional pages are available
meta.cursorstring | nullCursor for next page of results
meta.took_msnumber | nullQuery execution time in milliseconds
data[].categorystringThe category to which the product belongs
data[].create_timestringThe date and time when the product was created
data[].descriptionstringThe detailed description of the product
data[].home_urlstringThe URL for the home page of the product
data[].idstringThe unique identifier for the product
data[].image_urlstringThe URL to the image representing the product
data[].linksarrayContains links related to the product details.
data[].namestringThe name of the product
data[].typestringThe type or category of the product
data[].update_timestringThe date and time when the product was last updated

Search Invoices

Search Invoices List

Searches for invoices matching the specified criteria. Uses POST with a JSON body for filtering.

Python SDK

await paypal_transaction.search_invoices.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "search_invoices",
"action": "list"
}'

Parameters

Parameter NameTypeRequiredDescription
creation_date_rangeobjectNoFilter by invoice creation date range.
creation_date_range.startstringNoStart date in ISO 8601 format.
creation_date_range.endstringNoEnd date in ISO 8601 format.
page_sizeintegerNoNumber of items per page (max 100).
pageintegerNoPage number starting from 1.
Response Schema

Records

Field NameTypeDescription
idstring
statusstring
detailobject
invoicerobject
primary_recipientsarray<object>
additional_recipientsarray<string>
itemsarray<object>
amountobject
configurationobject
due_amountobject
due_amount.currency_codestring
due_amount.valuestring
paymentsobject
refundsobject
linksarray<object>

Search and filter search invoices records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.

Python SDK

await paypal_transaction.search_invoices.search(
query={"filter": {"eq": {"additional_recipients": []}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "search_invoices",
"action": "search",
"params": {
"query": {"filter": {"eq": {"additional_recipients": []}}}
}
}'

Parameters

Parameter NameTypeRequiredDescription
queryobjectYesFilter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or
query.filterobjectNoFilter conditions
query.sortarrayNoSort conditions
limitintegerNoMaximum results to return (default 1000)
cursorstringNoPagination cursor from previous response's meta.cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
additional_recipientsarrayList of additional recipients associated with the invoice
amountobjectDetailed breakdown of the invoice amount
configurationobjectConfiguration settings related to the invoice
detailobjectDetailed information about the invoice
due_amountobjectDue amount remaining to be paid for the invoice
gratuityobjectGratuity amount included in the invoice
idstringUnique identifier of the invoice
invoicerobjectInformation about the invoicer associated with the invoice
last_update_timestringDate and time of the last update made to the invoice
linksarrayLinks associated with the invoice
paymentsobjectPayment transactions associated with the invoice
primary_recipientsarrayPrimary recipients associated with the invoice
refundsobjectRefund transactions associated with the invoice
statusstringCurrent status of the invoice
Response Schema
Field NameTypeDescription
dataarrayList of matching records
metaobjectPagination metadata
meta.has_morebooleanWhether additional pages are available
meta.cursorstring | nullCursor for next page of results
meta.took_msnumber | nullQuery execution time in milliseconds
data[].additional_recipientsarrayList of additional recipients associated with the invoice
data[].amountobjectDetailed breakdown of the invoice amount
data[].configurationobjectConfiguration settings related to the invoice
data[].detailobjectDetailed information about the invoice
data[].due_amountobjectDue amount remaining to be paid for the invoice
data[].gratuityobjectGratuity amount included in the invoice
data[].idstringUnique identifier of the invoice
data[].invoicerobjectInformation about the invoicer associated with the invoice
data[].last_update_timestringDate and time of the last update made to the invoice
data[].linksarrayLinks associated with the invoice
data[].paymentsobjectPayment transactions associated with the invoice
data[].primary_recipientsarrayPrimary recipients associated with the invoice
data[].refundsobjectRefund transactions associated with the invoice
data[].statusstringCurrent status of the invoice