Skip to main content

Stripe full reference

This is the full reference documentation for the Stripe agent connector.

Supported entities and actions

The Stripe connector supports the following entities and actions.

EntityActions
CustomersList, Create, Get, Update, Delete, API Search, Search
InvoicesList, Get, API Search, Search
ChargesList, Get, API Search, Search
SubscriptionsList, Get, API Search, Search
RefundsList, Create, Get, Search
ProductsList, Create, Get, Update, Delete, API Search
BalanceGet
Balance TransactionsList, Get
Payment IntentsList, Get, API Search
DisputesList, Get
PayoutsList, Get

Customers

Customers List

Returns a list of your customers. The customers are returned sorted by creation date, with the most recent customers appearing first.

Python SDK

await stripe.customers.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.
emailstringNoA case-sensitive filter on the list based on the customer's email field. The value must be a string.
createdobjectNoOnly return customers that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
Response Schema

Records

Field NameTypeDescription
idstring
object"customer"
addressobject | null
balanceinteger
business_namestring | null
cash_balanceobject | null
createdinteger
currencystring | null
customer_accountstring | null
default_currencystring | null
default_sourcestring | null
delinquentboolean | null
descriptionstring | null
discountobject | null
emailstring | null
individual_namestring | null
invoice_credit_balanceobject
invoice_prefixstring | null
invoice_settingsobject
livemodeboolean
metadataobject
namestring | null
next_invoice_sequenceinteger | null
phonestring | null
preferred_localesarray | null
shippingobject | null
sourcesobject | null
subscriptionsobject | null
tax_exemptstring | null
test_clockstring | null

Meta

Field NameTypeDescription
has_moreboolean

Customers Create

Creates a new customer object.

Python SDK

await stripe.customers.create()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "customers",
"action": "create"
}'
Response Schema

Records

Field NameTypeDescription
idstring
object"customer"
addressobject | null
balanceinteger
business_namestring | null
cash_balanceobject | null
createdinteger
currencystring | null
customer_accountstring | null
default_currencystring | null
default_sourcestring | null
delinquentboolean | null
descriptionstring | null
discountobject | null
emailstring | null
individual_namestring | null
invoice_credit_balanceobject
invoice_prefixstring | null
invoice_settingsobject
livemodeboolean
metadataobject
namestring | null
next_invoice_sequenceinteger | null
phonestring | null
preferred_localesarray | null
shippingobject | null
sourcesobject | null
subscriptionsobject | null
tax_exemptstring | null
test_clockstring | null

Customers Get

Retrieves a Customer object.

Python SDK

await stripe.customers.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe customer ID
Response Schema

Records

Field NameTypeDescription
idstring
object"customer"
addressobject | null
balanceinteger
business_namestring | null
cash_balanceobject | null
createdinteger
currencystring | null
customer_accountstring | null
default_currencystring | null
default_sourcestring | null
delinquentboolean | null
descriptionstring | null
discountobject | null
emailstring | null
individual_namestring | null
invoice_credit_balanceobject
invoice_prefixstring | null
invoice_settingsobject
livemodeboolean
metadataobject
namestring | null
next_invoice_sequenceinteger | null
phonestring | null
preferred_localesarray | null
shippingobject | null
sourcesobject | null
subscriptionsobject | null
tax_exemptstring | null
test_clockstring | null

Customers Update

Updates the specified customer by setting the values of the parameters passed.

Python SDK

await stripe.customers.update(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe customer ID
Response Schema

Records

Field NameTypeDescription
idstring
object"customer"
addressobject | null
balanceinteger
business_namestring | null
cash_balanceobject | null
createdinteger
currencystring | null
customer_accountstring | null
default_currencystring | null
default_sourcestring | null
delinquentboolean | null
descriptionstring | null
discountobject | null
emailstring | null
individual_namestring | null
invoice_credit_balanceobject
invoice_prefixstring | null
invoice_settingsobject
livemodeboolean
metadataobject
namestring | null
next_invoice_sequenceinteger | null
phonestring | null
preferred_localesarray | null
shippingobject | null
sourcesobject | null
subscriptionsobject | null
tax_exemptstring | null
test_clockstring | null

Customers Delete

Permanently deletes a customer. It cannot be undone.

Python SDK

await stripe.customers.delete(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe customer ID
Response Schema

Records

Field NameTypeDescription
idstring
object"customer"
deletedboolean

Search for customers using Stripe's Search Query Language.

Python SDK

await stripe.customers.api_search(
query="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "customers",
"action": "api_search",
"params": {
"query": "<str>"
}
}'

Parameters

Parameter NameTypeRequiredDescription
querystringYesThe search query string using Stripe's Search Query Language
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
pagestringNoA cursor for pagination across multiple pages of results. Don’t include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
Response Schema

Records

Field NameTypeDescription
idstring
object"customer"
addressobject | null
balanceinteger
business_namestring | null
cash_balanceobject | null
createdinteger
currencystring | null
customer_accountstring | null
default_currencystring | null
default_sourcestring | null
delinquentboolean | null
descriptionstring | null
discountobject | null
emailstring | null
individual_namestring | null
invoice_credit_balanceobject
invoice_prefixstring | null
invoice_settingsobject
livemodeboolean
metadataobject
namestring | null
next_invoice_sequenceinteger | null
phonestring | null
preferred_localesarray | null
shippingobject | null
sourcesobject | null
subscriptionsobject | null
tax_exemptstring | null
test_clockstring | null

Meta

Field NameTypeDescription
has_moreboolean

Search and filter customers 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 stripe.customers.search(
query={"filter": {"eq": {"account_balance": 0}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "customers",
"action": "search",
"params": {
"query": {"filter": {"eq": {"account_balance": 0}}}
}
}'

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 next_cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
account_balanceintegerCurrent balance value representing funds owed by or to the customer.
addressobjectThe customer's address information including line1, line2, city, state, postal code, and country.
balanceintegerCurrent balance (positive or negative) that is automatically applied to the customer's next invoice.
cardsarrayCard payment methods associated with the customer account.
createdintegerTimestamp indicating when the customer object was created.
currencystringThree-letter ISO currency code representing the customer's default currency.
default_cardstringThe default card to be used for charges when no specific payment method is provided.
default_sourcestringThe default payment source (card or bank account) for the customer.
delinquentbooleanBoolean indicating whether the customer is currently delinquent on payments.
descriptionstringAn arbitrary string attached to the customer, often useful for displaying to users.
discountobjectDiscount object describing any active discount applied to the customer.
emailstringThe customer's email address for communication and tracking purposes.
idstringUnique identifier for the customer object.
invoice_prefixstringThe prefix for invoice numbers generated for this customer.
invoice_settingsobjectCustomer's invoice-related settings including default payment method and custom fields.
is_deletedbooleanBoolean indicating whether the customer has been deleted.
livemodebooleanBoolean indicating whether the object exists in live mode or test mode.
metadataobjectSet of key-value pairs for storing additional structured information about the customer.
namestringThe customer's full name or business name.
next_invoice_sequenceintegerThe sequence number for the next invoice generated for this customer.
objectstringString representing the object type, always 'customer'.
phonestringThe customer's phone number.
preferred_localesarrayArray of preferred locales for the customer, used for invoice and receipt localization.
shippingobjectMailing and shipping address for the customer, appears on invoices emailed to the customer.
sourcesstringPayment sources (cards, bank accounts) attached to the customer for making payments.
subscriptionsobjectList of active subscriptions associated with the customer.
tax_exemptstringDescribes the customer's tax exemption status (none, exempt, or reverse).
tax_infostringTax identification information for the customer.
tax_info_verificationstringVerification status of the customer's tax information.
test_clockstringID of the test clock associated with this customer for testing time-dependent scenarios.
updatedintegerTimestamp indicating when the customer object was last updated.
Response Schema
Field NameTypeDescription
hitsarrayList of matching records
hits[].idstringRecord identifier
hits[].scorenumberRelevance score
hits[].dataobjectRecord data containing the searchable fields listed above
hits[].data.account_balanceintegerCurrent balance value representing funds owed by or to the customer.
hits[].data.addressobjectThe customer's address information including line1, line2, city, state, postal code, and country.
hits[].data.balanceintegerCurrent balance (positive or negative) that is automatically applied to the customer's next invoice.
hits[].data.cardsarrayCard payment methods associated with the customer account.
hits[].data.createdintegerTimestamp indicating when the customer object was created.
hits[].data.currencystringThree-letter ISO currency code representing the customer's default currency.
hits[].data.default_cardstringThe default card to be used for charges when no specific payment method is provided.
hits[].data.default_sourcestringThe default payment source (card or bank account) for the customer.
hits[].data.delinquentbooleanBoolean indicating whether the customer is currently delinquent on payments.
hits[].data.descriptionstringAn arbitrary string attached to the customer, often useful for displaying to users.
hits[].data.discountobjectDiscount object describing any active discount applied to the customer.
hits[].data.emailstringThe customer's email address for communication and tracking purposes.
hits[].data.idstringUnique identifier for the customer object.
hits[].data.invoice_prefixstringThe prefix for invoice numbers generated for this customer.
hits[].data.invoice_settingsobjectCustomer's invoice-related settings including default payment method and custom fields.
hits[].data.is_deletedbooleanBoolean indicating whether the customer has been deleted.
hits[].data.livemodebooleanBoolean indicating whether the object exists in live mode or test mode.
hits[].data.metadataobjectSet of key-value pairs for storing additional structured information about the customer.
hits[].data.namestringThe customer's full name or business name.
hits[].data.next_invoice_sequenceintegerThe sequence number for the next invoice generated for this customer.
hits[].data.objectstringString representing the object type, always 'customer'.
hits[].data.phonestringThe customer's phone number.
hits[].data.preferred_localesarrayArray of preferred locales for the customer, used for invoice and receipt localization.
hits[].data.shippingobjectMailing and shipping address for the customer, appears on invoices emailed to the customer.
hits[].data.sourcesstringPayment sources (cards, bank accounts) attached to the customer for making payments.
hits[].data.subscriptionsobjectList of active subscriptions associated with the customer.
hits[].data.tax_exemptstringDescribes the customer's tax exemption status (none, exempt, or reverse).
hits[].data.tax_infostringTax identification information for the customer.
hits[].data.tax_info_verificationstringVerification status of the customer's tax information.
hits[].data.test_clockstringID of the test clock associated with this customer for testing time-dependent scenarios.
hits[].data.updatedintegerTimestamp indicating when the customer object was last updated.
next_cursorstring | nullCursor for next page of results
took_msnumberQuery execution time in milliseconds

Invoices

Invoices List

Returns a list of invoices

Python SDK

await stripe.invoices.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
collection_method"charge_automatically" | "send_invoice"NoThe collection method of the invoices to retrieve
createdobjectNoOnly return customers that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
customerstringNoOnly return invoices for the customer specified by this customer ID.
customer_accountstringNoOnly return invoices for the account specified by this account ID
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.
status"draft" | "open" | "paid" | "uncollectible" | "void"NoThe status of the invoices to retrieve
subscriptionstringNoOnly return invoices for the subscription specified by this subscription ID.
Response Schema

Records

Field NameTypeDescription
idstring
object"invoice"
account_countrystring | null
account_namestring | null
account_tax_idsarray | null
amount_dueinteger
amount_overpaidinteger
amount_paidinteger
amount_remaininginteger
amount_shippinginteger
applicationstring | null
application_fee_amountinteger | null
attempt_countinteger
attemptedboolean
auto_advanceboolean
automatic_taxobject
automatically_finalizes_atinteger | null
billing_reasonstring | null
chargestring | null
collection_method"charge_automatically" | "send_invoice"
confirmation_secretobject | null
createdinteger
currencystring
custom_fieldsarray | null
customerstring
customer_accountstring | null
customer_addressobject | null
customer_emailstring | null
customer_namestring | null
customer_phonestring | null
customer_shippingobject | null
customer_tax_exemptstring | null
customer_tax_idsarray | null
default_payment_methodstring | null
default_sourcestring | null
default_tax_ratesarray<object>
descriptionstring | null
discountobject | null
discountsarray<string>
due_dateinteger | null
effective_atinteger | null
ending_balanceinteger | null
footerstring | null
from_invoiceobject | null
hosted_invoice_urlstring | null
invoice_pdfstring | null
issuerobject
last_finalization_errorobject | null
latest_revisionstring | null
linesobject
livemodeboolean
metadataobject
next_payment_attemptinteger | null
numberstring | null
on_behalf_ofstring | null
paidboolean | null
paid_out_of_bandboolean | null
parentobject | null
payment_intentstring | null
payment_settingsobject
paymentsobject
period_endinteger
period_startinteger
post_payment_credit_notes_amountinteger
pre_payment_credit_notes_amountinteger
quotestring | null
receipt_numberstring | null
renderingobject | null
rendering_optionsobject | null
shipping_costobject | null
shipping_detailsobject | null
starting_balanceinteger
statement_descriptorstring | null
statusstring | null
status_transitionsobject
subscriptionstring | null
subscription_detailsobject | null
subtotalinteger
subtotal_excluding_taxinteger | null
taxinteger | null
test_clockstring | null
threshold_reasonobject | null
totalinteger
total_discount_amountsarray | null
total_excluding_taxinteger | null
total_pretax_credit_amountsarray | null
total_tax_amountsarray | null
total_taxesarray | null
transfer_dataobject | null
webhooks_delivered_atinteger | null

Meta

Field NameTypeDescription
has_moreboolean

Invoices Get

Retrieves the invoice with the given ID

Python SDK

await stripe.invoices.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe invoice ID
Response Schema

Records

Field NameTypeDescription
idstring
object"invoice"
account_countrystring | null
account_namestring | null
account_tax_idsarray | null
amount_dueinteger
amount_overpaidinteger
amount_paidinteger
amount_remaininginteger
amount_shippinginteger
applicationstring | null
application_fee_amountinteger | null
attempt_countinteger
attemptedboolean
auto_advanceboolean
automatic_taxobject
automatically_finalizes_atinteger | null
billing_reasonstring | null
chargestring | null
collection_method"charge_automatically" | "send_invoice"
confirmation_secretobject | null
createdinteger
currencystring
custom_fieldsarray | null
customerstring
customer_accountstring | null
customer_addressobject | null
customer_emailstring | null
customer_namestring | null
customer_phonestring | null
customer_shippingobject | null
customer_tax_exemptstring | null
customer_tax_idsarray | null
default_payment_methodstring | null
default_sourcestring | null
default_tax_ratesarray<object>
descriptionstring | null
discountobject | null
discountsarray<string>
due_dateinteger | null
effective_atinteger | null
ending_balanceinteger | null
footerstring | null
from_invoiceobject | null
hosted_invoice_urlstring | null
invoice_pdfstring | null
issuerobject
last_finalization_errorobject | null
latest_revisionstring | null
linesobject
livemodeboolean
metadataobject
next_payment_attemptinteger | null
numberstring | null
on_behalf_ofstring | null
paidboolean | null
paid_out_of_bandboolean | null
parentobject | null
payment_intentstring | null
payment_settingsobject
paymentsobject
period_endinteger
period_startinteger
post_payment_credit_notes_amountinteger
pre_payment_credit_notes_amountinteger
quotestring | null
receipt_numberstring | null
renderingobject | null
rendering_optionsobject | null
shipping_costobject | null
shipping_detailsobject | null
starting_balanceinteger
statement_descriptorstring | null
statusstring | null
status_transitionsobject
subscriptionstring | null
subscription_detailsobject | null
subtotalinteger
subtotal_excluding_taxinteger | null
taxinteger | null
test_clockstring | null
threshold_reasonobject | null
totalinteger
total_discount_amountsarray | null
total_excluding_taxinteger | null
total_pretax_credit_amountsarray | null
total_tax_amountsarray | null
total_taxesarray | null
transfer_dataobject | null
webhooks_delivered_atinteger | null

Search for invoices using Stripe's Search Query Language

Python SDK

await stripe.invoices.api_search(
query="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "invoices",
"action": "api_search",
"params": {
"query": "<str>"
}
}'

Parameters

Parameter NameTypeRequiredDescription
querystringYesThe search query string using Stripe's Search Query Language
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
pagestringNoA cursor for pagination across multiple pages of results. Don’t include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
Response Schema

Records

Field NameTypeDescription
object"search_result"
dataarray<object>
data[].idstring
data[].object"invoice"
data[].account_countrystring | null
data[].account_namestring | null
data[].account_tax_idsarray | null
data[].amount_dueinteger
data[].amount_overpaidinteger
data[].amount_paidinteger
data[].amount_remaininginteger
data[].amount_shippinginteger
data[].applicationstring | null
data[].application_fee_amountinteger | null
data[].attempt_countinteger
data[].attemptedboolean
data[].auto_advanceboolean
data[].automatic_taxobject
data[].automatically_finalizes_atinteger | null
data[].billing_reasonstring | null
data[].chargestring | null
data[].collection_method"charge_automatically" | "send_invoice"
data[].confirmation_secretobject | null
data[].createdinteger
data[].currencystring
data[].custom_fieldsarray | null
data[].customerstring
data[].customer_accountstring | null
data[].customer_addressobject | null
data[].customer_emailstring | null
data[].customer_namestring | null
data[].customer_phonestring | null
data[].customer_shippingobject | null
data[].customer_tax_exemptstring | null
data[].customer_tax_idsarray | null
data[].default_payment_methodstring | null
data[].default_sourcestring | null
data[].default_tax_ratesarray<object>
data[].descriptionstring | null
data[].discountobject | null
data[].discountsarray<string>
data[].due_dateinteger | null
data[].effective_atinteger | null
data[].ending_balanceinteger | null
data[].footerstring | null
data[].from_invoiceobject | null
data[].hosted_invoice_urlstring | null
data[].invoice_pdfstring | null
data[].issuerobject
data[].last_finalization_errorobject | null
data[].latest_revisionstring | null
data[].linesobject
data[].livemodeboolean
data[].metadataobject
data[].next_payment_attemptinteger | null
data[].numberstring | null
data[].on_behalf_ofstring | null
data[].paidboolean | null
data[].paid_out_of_bandboolean | null
data[].parentobject | null
data[].payment_intentstring | null
data[].payment_settingsobject
data[].paymentsobject
data[].period_endinteger
data[].period_startinteger
data[].post_payment_credit_notes_amountinteger
data[].pre_payment_credit_notes_amountinteger
data[].quotestring | null
data[].receipt_numberstring | null
data[].renderingobject | null
data[].rendering_optionsobject | null
data[].shipping_costobject | null
data[].shipping_detailsobject | null
data[].starting_balanceinteger
data[].statement_descriptorstring | null
data[].statusstring | null
data[].status_transitionsobject
data[].subscriptionstring | null
data[].subscription_detailsobject | null
data[].subtotalinteger
data[].subtotal_excluding_taxinteger | null
data[].taxinteger | null
data[].test_clockstring | null
data[].threshold_reasonobject | null
data[].totalinteger
data[].total_discount_amountsarray | null
data[].total_excluding_taxinteger | null
data[].total_pretax_credit_amountsarray | null
data[].total_tax_amountsarray | null
data[].total_taxesarray | null
data[].transfer_dataobject | null
data[].webhooks_delivered_atinteger | null
has_moreboolean
next_pagestring | null
urlstring

Search and filter 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 stripe.invoices.search(
query={"filter": {"eq": {"account_country": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "invoices",
"action": "search",
"params": {
"query": {"filter": {"eq": {"account_country": "<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 next_cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
account_countrystringThe country of the business associated with this invoice, commonly used to display localized content.
account_namestringThe public name of the business associated with this invoice.
account_tax_idsarrayTax IDs of the account associated with this invoice.
amount_dueintegerTotal amount, in smallest currency unit, that is due and owed by the customer.
amount_paidintegerTotal amount, in smallest currency unit, that has been paid by the customer.
amount_remainingintegerThe difference between amount_due and amount_paid, representing the outstanding balance.
amount_shippingintegerTotal amount of shipping costs on the invoice.
applicationstringID of the Connect application that created this invoice.
application_feeintegerAmount of application fee charged for this invoice in a Connect scenario.
application_fee_amountintegerThe fee in smallest currency unit that is collected by the application in a Connect scenario.
attempt_countintegerNumber of payment attempts made for this invoice.
attemptedbooleanWhether an attempt has been made to pay the invoice.
auto_advancebooleanControls whether Stripe performs automatic collection of the invoice.
automatic_taxobjectSettings and status for automatic tax calculation on this invoice.
billingstringBilling method used for the invoice (charge_automatically or send_invoice).
billing_reasonstringIndicates the reason why the invoice was created (subscription_cycle, manual, etc.).
chargestringID of the latest charge generated for this invoice, if any.
closedbooleanWhether the invoice has been marked as closed and no longer open for collection.
collection_methodstringMethod by which the invoice is collected: charge_automatically or send_invoice.
createdintegerTimestamp indicating when the invoice was created.
currencystringThree-letter ISO currency code in which the invoice is denominated.
custom_fieldsarrayCustom fields displayed on the invoice as specified by the account.
customerstringThe customer object or ID associated with this invoice.
customer_addressobjectThe customer's address at the time the invoice was finalized.
customer_emailstringThe customer's email address at the time the invoice was finalized.
customer_namestringThe customer's name at the time the invoice was finalized.
customer_phonestringThe customer's phone number at the time the invoice was finalized.
customer_shippingobjectThe customer's shipping information at the time the invoice was finalized.
customer_tax_exemptstringThe customer's tax exempt status at the time the invoice was finalized.
customer_tax_idsarrayThe customer's tax IDs at the time the invoice was finalized.
default_payment_methodstringDefault payment method for the invoice, used if no other method is specified.
default_sourcestringDefault payment source for the invoice if no payment method is set.
default_tax_ratesarrayThe tax rates applied to the invoice by default.
descriptionstringAn arbitrary string attached to the invoice, often displayed to customers.
discountobjectThe discount object applied to the invoice, if any.
discountsarrayArray of discount IDs or objects currently applied to this invoice.
due_datenumberThe date by which payment on this invoice is due, if the invoice is not auto-collected.
effective_atintegerTimestamp when the invoice becomes effective and finalized for payment.
ending_balanceintegerThe customer's ending account balance after this invoice is finalized.
footerstringFooter text displayed on the invoice.
forgivenbooleanWhether the invoice has been forgiven and is considered paid without actual payment.
from_invoiceobjectDetails about the invoice this invoice was created from, if applicable.
hosted_invoice_urlstringURL for the hosted invoice page where customers can view and pay the invoice.
idstringUnique identifier for the invoice object.
invoice_pdfstringURL for the PDF version of the invoice.
is_deletedbooleanIndicates whether this invoice has been deleted.
issuerobjectDetails about the entity issuing the invoice.
last_finalization_errorobjectThe error encountered during the last finalization attempt, if any.
latest_revisionstringThe latest revision of the invoice, if revisions are enabled.
linesobjectThe individual line items that make up the invoice, representing products, services, or fees.
livemodebooleanIndicates whether the invoice exists in live mode (true) or test mode (false).
metadataobjectKey-value pairs for storing additional structured information about the invoice.
next_payment_attemptnumberTimestamp of the next automatic payment attempt for this invoice, if applicable.
numberstringA unique, human-readable identifier for this invoice, often shown to customers.
objectstringString representing the object type, always 'invoice'.
on_behalf_ofstringThe account on behalf of which the invoice is being created, used in Connect scenarios.
paidbooleanWhether the invoice has been paid in full.
paid_out_of_bandbooleanWhether payment was made outside of Stripe and manually marked as paid.
paymentstringID of the payment associated with this invoice, if any.
payment_intentstringThe PaymentIntent associated with this invoice for processing payment.
payment_settingsobjectConfiguration settings for how payment should be collected on this invoice.
period_endnumberEnd date of the billing period covered by this invoice.
period_startnumberStart date of the billing period covered by this invoice.
post_payment_credit_notes_amountintegerTotal amount of credit notes issued after the invoice was paid.
pre_payment_credit_notes_amountintegerTotal amount of credit notes applied before payment was attempted.
quotestringThe quote from which this invoice was generated, if applicable.
receipt_numberstringThe receipt number displayed on the invoice, if available.
renderingobjectSettings that control how the invoice is rendered for display.
rendering_optionsobjectOptions for customizing the visual rendering of the invoice.
shipping_costobjectTotal cost of shipping charges included in the invoice.
shipping_detailsobjectDetailed shipping information for the invoice, including address and carrier.
starting_balanceintegerThe customer's starting account balance at the beginning of the billing period.
statement_descriptionstringExtra information about the invoice that appears on the customer's credit card statement.
statement_descriptorstringA dynamic descriptor that appears on the customer's credit card statement for this invoice.
statusstringThe status of the invoice: draft, open, paid, void, or uncollectible.
status_transitionsobjectTimestamps tracking when the invoice transitioned between different statuses.
subscriptionstringThe subscription this invoice was generated for, if applicable.
subscription_detailsobjectAdditional details about the subscription associated with this invoice.
subtotalintegerTotal of all line items before discounts or tax are applied.
subtotal_excluding_taxintegerThe subtotal amount excluding any tax calculations.
taxintegerTotal tax amount applied to the invoice.
tax_percentnumberThe percentage of tax applied to the invoice (deprecated, use total_tax_amounts instead).
test_clockstringID of the test clock this invoice belongs to, used for testing time-dependent billing.
totalintegerTotal amount of the invoice after all line items, discounts, and taxes are calculated.
total_discount_amountsarrayArray of the total discount amounts applied, broken down by discount.
total_excluding_taxintegerTotal amount of the invoice excluding all tax calculations.
total_tax_amountsarrayArray of tax amounts applied to the invoice, broken down by tax rate.
transfer_dataobjectInformation about the transfer of funds associated with this invoice in Connect scenarios.
updatedintegerTimestamp indicating when the invoice was last updated.
webhooks_delivered_atnumberTimestamp indicating when webhooks for this invoice were successfully delivered.
Response Schema
Field NameTypeDescription
hitsarrayList of matching records
hits[].idstringRecord identifier
hits[].scorenumberRelevance score
hits[].dataobjectRecord data containing the searchable fields listed above
hits[].data.account_countrystringThe country of the business associated with this invoice, commonly used to display localized content.
hits[].data.account_namestringThe public name of the business associated with this invoice.
hits[].data.account_tax_idsarrayTax IDs of the account associated with this invoice.
hits[].data.amount_dueintegerTotal amount, in smallest currency unit, that is due and owed by the customer.
hits[].data.amount_paidintegerTotal amount, in smallest currency unit, that has been paid by the customer.
hits[].data.amount_remainingintegerThe difference between amount_due and amount_paid, representing the outstanding balance.
hits[].data.amount_shippingintegerTotal amount of shipping costs on the invoice.
hits[].data.applicationstringID of the Connect application that created this invoice.
hits[].data.application_feeintegerAmount of application fee charged for this invoice in a Connect scenario.
hits[].data.application_fee_amountintegerThe fee in smallest currency unit that is collected by the application in a Connect scenario.
hits[].data.attempt_countintegerNumber of payment attempts made for this invoice.
hits[].data.attemptedbooleanWhether an attempt has been made to pay the invoice.
hits[].data.auto_advancebooleanControls whether Stripe performs automatic collection of the invoice.
hits[].data.automatic_taxobjectSettings and status for automatic tax calculation on this invoice.
hits[].data.billingstringBilling method used for the invoice (charge_automatically or send_invoice).
hits[].data.billing_reasonstringIndicates the reason why the invoice was created (subscription_cycle, manual, etc.).
hits[].data.chargestringID of the latest charge generated for this invoice, if any.
hits[].data.closedbooleanWhether the invoice has been marked as closed and no longer open for collection.
hits[].data.collection_methodstringMethod by which the invoice is collected: charge_automatically or send_invoice.
hits[].data.createdintegerTimestamp indicating when the invoice was created.
hits[].data.currencystringThree-letter ISO currency code in which the invoice is denominated.
hits[].data.custom_fieldsarrayCustom fields displayed on the invoice as specified by the account.
hits[].data.customerstringThe customer object or ID associated with this invoice.
hits[].data.customer_addressobjectThe customer's address at the time the invoice was finalized.
hits[].data.customer_emailstringThe customer's email address at the time the invoice was finalized.
hits[].data.customer_namestringThe customer's name at the time the invoice was finalized.
hits[].data.customer_phonestringThe customer's phone number at the time the invoice was finalized.
hits[].data.customer_shippingobjectThe customer's shipping information at the time the invoice was finalized.
hits[].data.customer_tax_exemptstringThe customer's tax exempt status at the time the invoice was finalized.
hits[].data.customer_tax_idsarrayThe customer's tax IDs at the time the invoice was finalized.
hits[].data.default_payment_methodstringDefault payment method for the invoice, used if no other method is specified.
hits[].data.default_sourcestringDefault payment source for the invoice if no payment method is set.
hits[].data.default_tax_ratesarrayThe tax rates applied to the invoice by default.
hits[].data.descriptionstringAn arbitrary string attached to the invoice, often displayed to customers.
hits[].data.discountobjectThe discount object applied to the invoice, if any.
hits[].data.discountsarrayArray of discount IDs or objects currently applied to this invoice.
hits[].data.due_datenumberThe date by which payment on this invoice is due, if the invoice is not auto-collected.
hits[].data.effective_atintegerTimestamp when the invoice becomes effective and finalized for payment.
hits[].data.ending_balanceintegerThe customer's ending account balance after this invoice is finalized.
hits[].data.footerstringFooter text displayed on the invoice.
hits[].data.forgivenbooleanWhether the invoice has been forgiven and is considered paid without actual payment.
hits[].data.from_invoiceobjectDetails about the invoice this invoice was created from, if applicable.
hits[].data.hosted_invoice_urlstringURL for the hosted invoice page where customers can view and pay the invoice.
hits[].data.idstringUnique identifier for the invoice object.
hits[].data.invoice_pdfstringURL for the PDF version of the invoice.
hits[].data.is_deletedbooleanIndicates whether this invoice has been deleted.
hits[].data.issuerobjectDetails about the entity issuing the invoice.
hits[].data.last_finalization_errorobjectThe error encountered during the last finalization attempt, if any.
hits[].data.latest_revisionstringThe latest revision of the invoice, if revisions are enabled.
hits[].data.linesobjectThe individual line items that make up the invoice, representing products, services, or fees.
hits[].data.livemodebooleanIndicates whether the invoice exists in live mode (true) or test mode (false).
hits[].data.metadataobjectKey-value pairs for storing additional structured information about the invoice.
hits[].data.next_payment_attemptnumberTimestamp of the next automatic payment attempt for this invoice, if applicable.
hits[].data.numberstringA unique, human-readable identifier for this invoice, often shown to customers.
hits[].data.objectstringString representing the object type, always 'invoice'.
hits[].data.on_behalf_ofstringThe account on behalf of which the invoice is being created, used in Connect scenarios.
hits[].data.paidbooleanWhether the invoice has been paid in full.
hits[].data.paid_out_of_bandbooleanWhether payment was made outside of Stripe and manually marked as paid.
hits[].data.paymentstringID of the payment associated with this invoice, if any.
hits[].data.payment_intentstringThe PaymentIntent associated with this invoice for processing payment.
hits[].data.payment_settingsobjectConfiguration settings for how payment should be collected on this invoice.
hits[].data.period_endnumberEnd date of the billing period covered by this invoice.
hits[].data.period_startnumberStart date of the billing period covered by this invoice.
hits[].data.post_payment_credit_notes_amountintegerTotal amount of credit notes issued after the invoice was paid.
hits[].data.pre_payment_credit_notes_amountintegerTotal amount of credit notes applied before payment was attempted.
hits[].data.quotestringThe quote from which this invoice was generated, if applicable.
hits[].data.receipt_numberstringThe receipt number displayed on the invoice, if available.
hits[].data.renderingobjectSettings that control how the invoice is rendered for display.
hits[].data.rendering_optionsobjectOptions for customizing the visual rendering of the invoice.
hits[].data.shipping_costobjectTotal cost of shipping charges included in the invoice.
hits[].data.shipping_detailsobjectDetailed shipping information for the invoice, including address and carrier.
hits[].data.starting_balanceintegerThe customer's starting account balance at the beginning of the billing period.
hits[].data.statement_descriptionstringExtra information about the invoice that appears on the customer's credit card statement.
hits[].data.statement_descriptorstringA dynamic descriptor that appears on the customer's credit card statement for this invoice.
hits[].data.statusstringThe status of the invoice: draft, open, paid, void, or uncollectible.
hits[].data.status_transitionsobjectTimestamps tracking when the invoice transitioned between different statuses.
hits[].data.subscriptionstringThe subscription this invoice was generated for, if applicable.
hits[].data.subscription_detailsobjectAdditional details about the subscription associated with this invoice.
hits[].data.subtotalintegerTotal of all line items before discounts or tax are applied.
hits[].data.subtotal_excluding_taxintegerThe subtotal amount excluding any tax calculations.
hits[].data.taxintegerTotal tax amount applied to the invoice.
hits[].data.tax_percentnumberThe percentage of tax applied to the invoice (deprecated, use total_tax_amounts instead).
hits[].data.test_clockstringID of the test clock this invoice belongs to, used for testing time-dependent billing.
hits[].data.totalintegerTotal amount of the invoice after all line items, discounts, and taxes are calculated.
hits[].data.total_discount_amountsarrayArray of the total discount amounts applied, broken down by discount.
hits[].data.total_excluding_taxintegerTotal amount of the invoice excluding all tax calculations.
hits[].data.total_tax_amountsarrayArray of tax amounts applied to the invoice, broken down by tax rate.
hits[].data.transfer_dataobjectInformation about the transfer of funds associated with this invoice in Connect scenarios.
hits[].data.updatedintegerTimestamp indicating when the invoice was last updated.
hits[].data.webhooks_delivered_atnumberTimestamp indicating when webhooks for this invoice were successfully delivered.
next_cursorstring | nullCursor for next page of results
took_msnumberQuery execution time in milliseconds

Charges

Charges List

Returns a list of charges you've previously created. The charges are returned in sorted order, with the most recent charges appearing first.

Python SDK

await stripe.charges.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
createdobjectNoOnly return customers that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
customerstringNoOnly return charges for the customer specified by this customer ID
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
payment_intentstringNoOnly return charges that were created by the PaymentIntent specified by this ID
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.
Response Schema

Records

Field NameTypeDescription
idstring
object"charge"
createdinteger
livemodeboolean
amountinteger
amount_capturedinteger
amount_refundedinteger
amount_updatesarray | null
applicationstring | null
application_feestring | null
application_fee_amountinteger | null
calculated_statement_descriptorstring | null
currencystring
customerstring | null
descriptionstring | null
destinationstring | null
disputestring | null
disputedboolean
failure_balance_transactionstring | null
failure_codestring | null
failure_messagestring | null
fraud_detailsobject | null
invoicestring | null
on_behalf_ofstring | null
orderstring | null
outcomeobject | null
paidboolean
payment_intentstring | null
payment_methodstring | null
payment_method_detailsobject | null
presentment_detailsobject | null
receipt_emailstring | null
receipt_numberstring | null
receipt_urlstring | null
refundedboolean
refundsobject | null
reviewstring | null
shippingobject | null
sourceobject | null
source_transferstring | null
statement_descriptorstring | null
statement_descriptor_suffixstring | null
status"succeeded" | "pending" | "failed"
transfer_dataobject | null
transfer_groupstring | null
capturedboolean
balance_transactionstring | null
billing_detailsobject
metadataobject
radar_optionsobject | null

Meta

Field NameTypeDescription
has_moreboolean

Charges Get

Retrieves the details of a charge that has previously been created

Python SDK

await stripe.charges.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe charge ID
Response Schema

Records

Field NameTypeDescription
idstring
object"charge"
createdinteger
livemodeboolean
amountinteger
amount_capturedinteger
amount_refundedinteger
amount_updatesarray | null
applicationstring | null
application_feestring | null
application_fee_amountinteger | null
calculated_statement_descriptorstring | null
currencystring
customerstring | null
descriptionstring | null
destinationstring | null
disputestring | null
disputedboolean
failure_balance_transactionstring | null
failure_codestring | null
failure_messagestring | null
fraud_detailsobject | null
invoicestring | null
on_behalf_ofstring | null
orderstring | null
outcomeobject | null
paidboolean
payment_intentstring | null
payment_methodstring | null
payment_method_detailsobject | null
presentment_detailsobject | null
receipt_emailstring | null
receipt_numberstring | null
receipt_urlstring | null
refundedboolean
refundsobject | null
reviewstring | null
shippingobject | null
sourceobject | null
source_transferstring | null
statement_descriptorstring | null
statement_descriptor_suffixstring | null
status"succeeded" | "pending" | "failed"
transfer_dataobject | null
transfer_groupstring | null
capturedboolean
balance_transactionstring | null
billing_detailsobject
metadataobject
radar_optionsobject | null

Search for charges using Stripe's Search Query Language

Python SDK

await stripe.charges.api_search(
query="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "charges",
"action": "api_search",
"params": {
"query": "<str>"
}
}'

Parameters

Parameter NameTypeRequiredDescription
querystringYesThe search query string using Stripe's Search Query Language
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
pagestringNoA cursor for pagination across multiple pages of results. Don’t include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
Response Schema

Records

Field NameTypeDescription
object"search_result"
dataarray<object>
data[].idstring
data[].object"charge"
data[].createdinteger
data[].livemodeboolean
data[].amountinteger
data[].amount_capturedinteger
data[].amount_refundedinteger
data[].amount_updatesarray | null
data[].applicationstring | null
data[].application_feestring | null
data[].application_fee_amountinteger | null
data[].calculated_statement_descriptorstring | null
data[].currencystring
data[].customerstring | null
data[].descriptionstring | null
data[].destinationstring | null
data[].disputestring | null
data[].disputedboolean
data[].failure_balance_transactionstring | null
data[].failure_codestring | null
data[].failure_messagestring | null
data[].fraud_detailsobject | null
data[].invoicestring | null
data[].on_behalf_ofstring | null
data[].orderstring | null
data[].outcomeobject | null
data[].paidboolean
data[].payment_intentstring | null
data[].payment_methodstring | null
data[].payment_method_detailsobject | null
data[].presentment_detailsobject | null
data[].receipt_emailstring | null
data[].receipt_numberstring | null
data[].receipt_urlstring | null
data[].refundedboolean
data[].refundsobject | null
data[].reviewstring | null
data[].shippingobject | null
data[].sourceobject | null
data[].source_transferstring | null
data[].statement_descriptorstring | null
data[].statement_descriptor_suffixstring | null
data[].status"succeeded" | "pending" | "failed"
data[].transfer_dataobject | null
data[].transfer_groupstring | null
data[].capturedboolean
data[].balance_transactionstring | null
data[].billing_detailsobject
data[].metadataobject
data[].radar_optionsobject | null
has_moreboolean
next_pagestring | null
urlstring

Search and filter charges 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 stripe.charges.search(
query={"filter": {"eq": {"amount": 0}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "charges",
"action": "search",
"params": {
"query": {"filter": {"eq": {"amount": 0}}}
}
}'

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 next_cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
amountintegerAmount intended to be collected by this payment in the smallest currency unit (e.g., 100 cents for $1.00), supporting up to eight digits.
amount_capturedintegerAmount that was actually captured from this charge.
amount_refundedintegerAmount that has been refunded back to the customer.
amount_updatesarrayUpdates to the amount that have been made during the charge lifecycle.
applicationstringID of the application that created this charge (Connect only).
application_feestringID of the application fee associated with this charge (Connect only).
application_fee_amountintegerThe amount of the application fee deducted from this charge (Connect only).
balance_transactionstringID of the balance transaction that describes the impact of this charge on your account balance (excluding refunds or disputes).
billing_detailsobjectBilling information associated with the payment method at the time of the transaction, including name, email, phone, and address.
calculated_statement_descriptorstringThe full statement descriptor that appears on the customer's credit card statement, combining prefix and suffix.
capturedbooleanWhether the charge has been captured and funds transferred to your account.
cardobjectDeprecated card object containing payment card details if a card was used.
createdintegerTimestamp indicating when the charge was created.
currencystringThree-letter ISO currency code in lowercase (e.g., 'usd', 'eur') for the charge amount.
customerstringID of the customer this charge is for, if one exists.
descriptionstringAn arbitrary string attached to the charge, often useful for displaying to users or internal reference.
destinationstringID of the destination account where funds are transferred (Connect only).
disputestringID of the dispute object if the charge has been disputed.
disputedbooleanWhether the charge has been disputed by the customer with their card issuer.
failure_balance_transactionstringID of the balance transaction that describes the reversal of funds if the charge failed.
failure_codestringError code explaining the reason for charge failure, if applicable.
failure_messagestringHuman-readable message providing more details about why the charge failed.
fraud_detailsobjectInformation about fraud assessments and user reports related to this charge.
idstringUnique identifier for the charge, used to link transactions across other records.
invoicestringID of the invoice this charge is for, if the charge was created by invoicing.
livemodebooleanWhether the charge occurred in live mode (true) or test mode (false).
metadataobjectKey-value pairs for storing additional structured information about the charge, useful for internal tracking.
objectstringString representing the object type, always 'charge' for charge objects.
on_behalf_ofstringID of the account on whose behalf the charge was made (Connect only).
orderstringDeprecated field for order information associated with this charge.
outcomeobjectDetails about the outcome of the charge, including network status, risk assessment, and reason codes.
paidbooleanWhether the charge succeeded and funds were successfully collected.
payment_intentstringID of the PaymentIntent associated with this charge, if one exists.
payment_methodstringID of the payment method used for this charge.
payment_method_detailsobjectDetails about the payment method at the time of the transaction, including card brand, network, and authentication results.
receipt_emailstringEmail address to which the receipt for this charge was sent.
receipt_numberstringReceipt number that appears on email receipts sent for this charge.
receipt_urlstringURL to a hosted receipt page for this charge, viewable by the customer.
refundedbooleanWhether the charge has been fully refunded (partial refunds will still show as false).
refundsobjectList of refunds that have been applied to this charge.
reviewstringID of the review object associated with this charge, if it was flagged for manual review.
shippingobjectShipping information for the charge, including recipient name, address, and tracking details.
sourceobjectDeprecated payment source object used to create this charge.
source_transferstringID of the transfer from a source account if funds came from another Stripe account (Connect only).
statement_descriptionstringDeprecated alias for statement_descriptor.
statement_descriptorstringStatement descriptor that overrides the account default for card charges, appearing on the customer's statement.
statement_descriptor_suffixstringSuffix concatenated to the account's statement descriptor prefix to form the complete descriptor on customer statements.
statusstringCurrent status of the payment: 'succeeded' (completed), 'pending' (processing), or 'failed' (unsuccessful).
transfer_dataobjectObject containing destination and amount for transfers to connected accounts (Connect only).
transfer_groupstringString identifier for grouping related charges and transfers together (Connect only).
updatedintegerTimestamp of the last update to this charge object.
Response Schema
Field NameTypeDescription
hitsarrayList of matching records
hits[].idstringRecord identifier
hits[].scorenumberRelevance score
hits[].dataobjectRecord data containing the searchable fields listed above
hits[].data.amountintegerAmount intended to be collected by this payment in the smallest currency unit (e.g., 100 cents for $1.00), supporting up to eight digits.
hits[].data.amount_capturedintegerAmount that was actually captured from this charge.
hits[].data.amount_refundedintegerAmount that has been refunded back to the customer.
hits[].data.amount_updatesarrayUpdates to the amount that have been made during the charge lifecycle.
hits[].data.applicationstringID of the application that created this charge (Connect only).
hits[].data.application_feestringID of the application fee associated with this charge (Connect only).
hits[].data.application_fee_amountintegerThe amount of the application fee deducted from this charge (Connect only).
hits[].data.balance_transactionstringID of the balance transaction that describes the impact of this charge on your account balance (excluding refunds or disputes).
hits[].data.billing_detailsobjectBilling information associated with the payment method at the time of the transaction, including name, email, phone, and address.
hits[].data.calculated_statement_descriptorstringThe full statement descriptor that appears on the customer's credit card statement, combining prefix and suffix.
hits[].data.capturedbooleanWhether the charge has been captured and funds transferred to your account.
hits[].data.cardobjectDeprecated card object containing payment card details if a card was used.
hits[].data.createdintegerTimestamp indicating when the charge was created.
hits[].data.currencystringThree-letter ISO currency code in lowercase (e.g., 'usd', 'eur') for the charge amount.
hits[].data.customerstringID of the customer this charge is for, if one exists.
hits[].data.descriptionstringAn arbitrary string attached to the charge, often useful for displaying to users or internal reference.
hits[].data.destinationstringID of the destination account where funds are transferred (Connect only).
hits[].data.disputestringID of the dispute object if the charge has been disputed.
hits[].data.disputedbooleanWhether the charge has been disputed by the customer with their card issuer.
hits[].data.failure_balance_transactionstringID of the balance transaction that describes the reversal of funds if the charge failed.
hits[].data.failure_codestringError code explaining the reason for charge failure, if applicable.
hits[].data.failure_messagestringHuman-readable message providing more details about why the charge failed.
hits[].data.fraud_detailsobjectInformation about fraud assessments and user reports related to this charge.
hits[].data.idstringUnique identifier for the charge, used to link transactions across other records.
hits[].data.invoicestringID of the invoice this charge is for, if the charge was created by invoicing.
hits[].data.livemodebooleanWhether the charge occurred in live mode (true) or test mode (false).
hits[].data.metadataobjectKey-value pairs for storing additional structured information about the charge, useful for internal tracking.
hits[].data.objectstringString representing the object type, always 'charge' for charge objects.
hits[].data.on_behalf_ofstringID of the account on whose behalf the charge was made (Connect only).
hits[].data.orderstringDeprecated field for order information associated with this charge.
hits[].data.outcomeobjectDetails about the outcome of the charge, including network status, risk assessment, and reason codes.
hits[].data.paidbooleanWhether the charge succeeded and funds were successfully collected.
hits[].data.payment_intentstringID of the PaymentIntent associated with this charge, if one exists.
hits[].data.payment_methodstringID of the payment method used for this charge.
hits[].data.payment_method_detailsobjectDetails about the payment method at the time of the transaction, including card brand, network, and authentication results.
hits[].data.receipt_emailstringEmail address to which the receipt for this charge was sent.
hits[].data.receipt_numberstringReceipt number that appears on email receipts sent for this charge.
hits[].data.receipt_urlstringURL to a hosted receipt page for this charge, viewable by the customer.
hits[].data.refundedbooleanWhether the charge has been fully refunded (partial refunds will still show as false).
hits[].data.refundsobjectList of refunds that have been applied to this charge.
hits[].data.reviewstringID of the review object associated with this charge, if it was flagged for manual review.
hits[].data.shippingobjectShipping information for the charge, including recipient name, address, and tracking details.
hits[].data.sourceobjectDeprecated payment source object used to create this charge.
hits[].data.source_transferstringID of the transfer from a source account if funds came from another Stripe account (Connect only).
hits[].data.statement_descriptionstringDeprecated alias for statement_descriptor.
hits[].data.statement_descriptorstringStatement descriptor that overrides the account default for card charges, appearing on the customer's statement.
hits[].data.statement_descriptor_suffixstringSuffix concatenated to the account's statement descriptor prefix to form the complete descriptor on customer statements.
hits[].data.statusstringCurrent status of the payment: 'succeeded' (completed), 'pending' (processing), or 'failed' (unsuccessful).
hits[].data.transfer_dataobjectObject containing destination and amount for transfers to connected accounts (Connect only).
hits[].data.transfer_groupstringString identifier for grouping related charges and transfers together (Connect only).
hits[].data.updatedintegerTimestamp of the last update to this charge object.
next_cursorstring | nullCursor for next page of results
took_msnumberQuery execution time in milliseconds

Subscriptions

Subscriptions List

By default, returns a list of subscriptions that have not been canceled

Python SDK

await stripe.subscriptions.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
automatic_taxobjectNoFilter subscriptions by their automatic tax settings.
automatic_tax.enabledbooleanNoEnabled automatic tax calculation which will automatically compute tax rates on all invoices generated by the subscription.
collection_method"charge_automatically" | "send_invoice"NoThe collection method of the subscriptions to retrieve
createdobjectNoOnly return customers that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
current_period_endobjectNoOnly return subscriptions whose minimum item current_period_end falls within the given date interval.
current_period_end.gtintegerNoMinimum value to filter by (exclusive)
current_period_end.gteintegerNoMinimum value to filter by (inclusive)
current_period_end.ltintegerNoMaximum value to filter by (exclusive)
current_period_end.lteintegerNoMaximum value to filter by (inclusive)
current_period_startobjectNoOnly return subscriptions whose maximum item current_period_start falls within the given date interval.
current_period_start.gtintegerNoMinimum value to filter by (exclusive)
current_period_start.gteintegerNoMinimum value to filter by (inclusive)
current_period_start.ltintegerNoMaximum value to filter by (exclusive)
current_period_start.lteintegerNoMaximum value to filter by (inclusive)
customerstringNoOnly return subscriptions for the customer specified by this customer ID
customer_accountstringNoThe ID of the account whose subscriptions will be retrieved.
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
pricestringNoFilter for subscriptions that contain this recurring price ID.
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.
status"canceled" | "ended" | "all"NoThe status of the subscriptions to retrieve. Passing in a value of canceled will return all canceled subscriptions, including those belonging to deleted customers. Pass ended to find subscriptions that are canceled and subscriptions that are expired due to incomplete payment. Passing in a value of all will return subscriptions of all statuses. If no value is supplied, all subscriptions that have not been canceled are returned.
Response Schema

Records

Field NameTypeDescription
idstring
object"subscription"
applicationstring | null
application_fee_percentnumber | null
automatic_taxobject
billing_cycle_anchorinteger
billing_cycle_anchor_configobject | null
billing_modeobject
billing_thresholdsobject | null
cancel_atinteger | null
cancel_at_period_endboolean
canceled_atinteger | null
cancellation_detailsobject | null
collection_method"charge_automatically" | "send_invoice"
createdinteger
currencystring
customerstring
customer_accountstring | null
days_until_dueinteger | null
default_payment_methodstring | null
default_sourcestring | null
default_tax_ratesarray | null
descriptionstring | null
discountsarray<string>
ended_atinteger | null
invoice_settingsobject
itemsobject
latest_invoicestring | null
livemodeboolean
metadataobject
next_pending_invoice_item_invoiceinteger | null
on_behalf_ofstring | null
pause_collectionobject | null
payment_settingsobject | null
status"incomplete" | "incomplete_expired" | "trialing" | "active" | "past_due" | "canceled" | "unpaid" | "paused"
current_period_startinteger
current_period_endinteger
start_dateinteger
trial_startinteger | null
trial_endinteger | null
discountobject | null
planobject | null
quantityinteger | null
schedulestring | null
test_clockstring | null
transfer_dataobject | null
trial_settingsobject | null
pending_invoice_item_intervalobject | null
pending_setup_intentstring | null
pending_updateobject | null

Meta

Field NameTypeDescription
has_moreboolean

Subscriptions Get

Retrieves the subscription with the given ID

Python SDK

await stripe.subscriptions.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe subscription ID
Response Schema

Records

Field NameTypeDescription
idstring
object"subscription"
applicationstring | null
application_fee_percentnumber | null
automatic_taxobject
billing_cycle_anchorinteger
billing_cycle_anchor_configobject | null
billing_modeobject
billing_thresholdsobject | null
cancel_atinteger | null
cancel_at_period_endboolean
canceled_atinteger | null
cancellation_detailsobject | null
collection_method"charge_automatically" | "send_invoice"
createdinteger
currencystring
customerstring
customer_accountstring | null
days_until_dueinteger | null
default_payment_methodstring | null
default_sourcestring | null
default_tax_ratesarray | null
descriptionstring | null
discountsarray<string>
ended_atinteger | null
invoice_settingsobject
itemsobject
latest_invoicestring | null
livemodeboolean
metadataobject
next_pending_invoice_item_invoiceinteger | null
on_behalf_ofstring | null
pause_collectionobject | null
payment_settingsobject | null
status"incomplete" | "incomplete_expired" | "trialing" | "active" | "past_due" | "canceled" | "unpaid" | "paused"
current_period_startinteger
current_period_endinteger
start_dateinteger
trial_startinteger | null
trial_endinteger | null
discountobject | null
planobject | null
quantityinteger | null
schedulestring | null
test_clockstring | null
transfer_dataobject | null
trial_settingsobject | null
pending_invoice_item_intervalobject | null
pending_setup_intentstring | null
pending_updateobject | null

Search for subscriptions using Stripe's Search Query Language

Python SDK

await stripe.subscriptions.api_search(
query="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "subscriptions",
"action": "api_search",
"params": {
"query": "<str>"
}
}'

Parameters

Parameter NameTypeRequiredDescription
querystringYesThe search query string using Stripe's Search Query Language
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
pagestringNoA cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
Response Schema

Records

Field NameTypeDescription
object"search_result"
dataarray<object>
data[].idstring
data[].object"subscription"
data[].applicationstring | null
data[].application_fee_percentnumber | null
data[].automatic_taxobject
data[].billing_cycle_anchorinteger
data[].billing_cycle_anchor_configobject | null
data[].billing_modeobject
data[].billing_thresholdsobject | null
data[].cancel_atinteger | null
data[].cancel_at_period_endboolean
data[].canceled_atinteger | null
data[].cancellation_detailsobject | null
data[].collection_method"charge_automatically" | "send_invoice"
data[].createdinteger
data[].currencystring
data[].customerstring
data[].customer_accountstring | null
data[].days_until_dueinteger | null
data[].default_payment_methodstring | null
data[].default_sourcestring | null
data[].default_tax_ratesarray | null
data[].descriptionstring | null
data[].discountsarray<string>
data[].ended_atinteger | null
data[].invoice_settingsobject
data[].itemsobject
data[].latest_invoicestring | null
data[].livemodeboolean
data[].metadataobject
data[].next_pending_invoice_item_invoiceinteger | null
data[].on_behalf_ofstring | null
data[].pause_collectionobject | null
data[].payment_settingsobject | null
data[].status"incomplete" | "incomplete_expired" | "trialing" | "active" | "past_due" | "canceled" | "unpaid" | "paused"
data[].current_period_startinteger
data[].current_period_endinteger
data[].start_dateinteger
data[].trial_startinteger | null
data[].trial_endinteger | null
data[].discountobject | null
data[].planobject | null
data[].quantityinteger | null
data[].schedulestring | null
data[].test_clockstring | null
data[].transfer_dataobject | null
data[].trial_settingsobject | null
data[].pending_invoice_item_intervalobject | null
data[].pending_setup_intentstring | null
data[].pending_updateobject | null
has_moreboolean
next_pagestring | null
urlstring

Search and filter subscriptions 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 stripe.subscriptions.search(
query={"filter": {"eq": {"application": "<str>"}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "subscriptions",
"action": "search",
"params": {
"query": {"filter": {"eq": {"application": "<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 next_cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
applicationstringFor Connect platforms, the application associated with the subscription.
application_fee_percentnumberFor Connect platforms, the percentage of the subscription amount taken as an application fee.
automatic_taxobjectAutomatic tax calculation settings for the subscription.
billingstringBilling mode configuration for the subscription.
billing_cycle_anchornumberTimestamp determining when the billing cycle for the subscription starts.
billing_cycle_anchor_configobjectConfiguration for the subscription's billing cycle anchor behavior.
billing_thresholdsobjectDefines thresholds at which an invoice will be sent, controlling billing timing based on usage.
cancel_atnumberTimestamp indicating when the subscription is scheduled to be canceled.
cancel_at_period_endbooleanBoolean indicating whether the subscription will be canceled at the end of the current billing period.
canceled_atnumberTimestamp indicating when the subscription was canceled, if applicable.
cancellation_detailsobjectDetails about why and how the subscription was canceled.
collection_methodstringHow invoices are collected (charge_automatically or send_invoice).
createdintegerTimestamp indicating when the subscription was created.
currencystringThree-letter ISO currency code in lowercase indicating the currency for the subscription.
current_period_endnumberTimestamp marking the end of the current billing period.
current_period_startintegerTimestamp marking the start of the current billing period.
customerstringID of the customer who owns the subscription, expandable to full customer object.
days_until_dueintegerNumber of days until the invoice is due for subscriptions using send_invoice collection method.
default_payment_methodstringID of the default payment method for the subscription, taking precedence over default_source.
default_sourcestringID of the default payment source for the subscription.
default_tax_ratesarrayTax rates that apply to the subscription by default.
descriptionstringHuman-readable description of the subscription, displayable to the customer.
discountobjectDescribes any discount currently applied to the subscription.
ended_atnumberTimestamp indicating when the subscription ended, if applicable.
idstringUnique identifier for the subscription object.
invoice_settingsobjectSettings for invoices generated by this subscription, such as custom fields and footer.
is_deletedbooleanIndicates whether the subscription has been deleted.
itemsobjectList of subscription items, each with an attached price defining what the customer is subscribed to.
latest_invoicestringThe most recent invoice this subscription has generated, expandable to full invoice object.
livemodebooleanIndicates whether the subscription exists in live mode (true) or test mode (false).
metadataobjectSet of key-value pairs that you can attach to the subscription for storing additional structured information.
next_pending_invoice_item_invoiceintegerTimestamp when the next invoice for pending invoice items will be created.
objectstringString representing the object type, always 'subscription'.
on_behalf_ofstringFor Connect platforms, the account for which the subscription is being created or managed.
pause_collectionobjectConfiguration for pausing collection on the subscription while retaining the subscription structure.
payment_settingsobjectPayment settings for invoices generated by this subscription.
pending_invoice_item_intervalobjectSpecifies an interval for aggregating usage records into pending invoice items.
pending_setup_intentstringSetupIntent used for collecting user authentication when updating payment methods without immediate payment.
pending_updateobjectIf specified, pending updates that will be applied to the subscription once the latest_invoice has been paid.
planobjectThe plan associated with the subscription (deprecated, use items instead).
quantityintegerQuantity of the plan subscribed to (deprecated, use items instead).
schedulestringID of the subscription schedule managing this subscription's lifecycle, if applicable.
start_dateintegerTimestamp indicating when the subscription started.
statusstringCurrent status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, or paused).
tax_percentnumberThe percentage of tax applied to the subscription (deprecated, use default_tax_rates instead).
test_clockstringID of the test clock associated with this subscription for simulating time-based scenarios.
transfer_dataobjectFor Connect platforms, the account receiving funds from the subscription and optional percentage transferred.
trial_endnumberTimestamp indicating when the trial period ends, if applicable.
trial_settingsobjectSettings related to trial periods, including conditions for ending trials.
trial_startintegerTimestamp indicating when the trial period began, if applicable.
updatedintegerTimestamp indicating when the subscription was last updated.
Response Schema
Field NameTypeDescription
hitsarrayList of matching records
hits[].idstringRecord identifier
hits[].scorenumberRelevance score
hits[].dataobjectRecord data containing the searchable fields listed above
hits[].data.applicationstringFor Connect platforms, the application associated with the subscription.
hits[].data.application_fee_percentnumberFor Connect platforms, the percentage of the subscription amount taken as an application fee.
hits[].data.automatic_taxobjectAutomatic tax calculation settings for the subscription.
hits[].data.billingstringBilling mode configuration for the subscription.
hits[].data.billing_cycle_anchornumberTimestamp determining when the billing cycle for the subscription starts.
hits[].data.billing_cycle_anchor_configobjectConfiguration for the subscription's billing cycle anchor behavior.
hits[].data.billing_thresholdsobjectDefines thresholds at which an invoice will be sent, controlling billing timing based on usage.
hits[].data.cancel_atnumberTimestamp indicating when the subscription is scheduled to be canceled.
hits[].data.cancel_at_period_endbooleanBoolean indicating whether the subscription will be canceled at the end of the current billing period.
hits[].data.canceled_atnumberTimestamp indicating when the subscription was canceled, if applicable.
hits[].data.cancellation_detailsobjectDetails about why and how the subscription was canceled.
hits[].data.collection_methodstringHow invoices are collected (charge_automatically or send_invoice).
hits[].data.createdintegerTimestamp indicating when the subscription was created.
hits[].data.currencystringThree-letter ISO currency code in lowercase indicating the currency for the subscription.
hits[].data.current_period_endnumberTimestamp marking the end of the current billing period.
hits[].data.current_period_startintegerTimestamp marking the start of the current billing period.
hits[].data.customerstringID of the customer who owns the subscription, expandable to full customer object.
hits[].data.days_until_dueintegerNumber of days until the invoice is due for subscriptions using send_invoice collection method.
hits[].data.default_payment_methodstringID of the default payment method for the subscription, taking precedence over default_source.
hits[].data.default_sourcestringID of the default payment source for the subscription.
hits[].data.default_tax_ratesarrayTax rates that apply to the subscription by default.
hits[].data.descriptionstringHuman-readable description of the subscription, displayable to the customer.
hits[].data.discountobjectDescribes any discount currently applied to the subscription.
hits[].data.ended_atnumberTimestamp indicating when the subscription ended, if applicable.
hits[].data.idstringUnique identifier for the subscription object.
hits[].data.invoice_settingsobjectSettings for invoices generated by this subscription, such as custom fields and footer.
hits[].data.is_deletedbooleanIndicates whether the subscription has been deleted.
hits[].data.itemsobjectList of subscription items, each with an attached price defining what the customer is subscribed to.
hits[].data.latest_invoicestringThe most recent invoice this subscription has generated, expandable to full invoice object.
hits[].data.livemodebooleanIndicates whether the subscription exists in live mode (true) or test mode (false).
hits[].data.metadataobjectSet of key-value pairs that you can attach to the subscription for storing additional structured information.
hits[].data.next_pending_invoice_item_invoiceintegerTimestamp when the next invoice for pending invoice items will be created.
hits[].data.objectstringString representing the object type, always 'subscription'.
hits[].data.on_behalf_ofstringFor Connect platforms, the account for which the subscription is being created or managed.
hits[].data.pause_collectionobjectConfiguration for pausing collection on the subscription while retaining the subscription structure.
hits[].data.payment_settingsobjectPayment settings for invoices generated by this subscription.
hits[].data.pending_invoice_item_intervalobjectSpecifies an interval for aggregating usage records into pending invoice items.
hits[].data.pending_setup_intentstringSetupIntent used for collecting user authentication when updating payment methods without immediate payment.
hits[].data.pending_updateobjectIf specified, pending updates that will be applied to the subscription once the latest_invoice has been paid.
hits[].data.planobjectThe plan associated with the subscription (deprecated, use items instead).
hits[].data.quantityintegerQuantity of the plan subscribed to (deprecated, use items instead).
hits[].data.schedulestringID of the subscription schedule managing this subscription's lifecycle, if applicable.
hits[].data.start_dateintegerTimestamp indicating when the subscription started.
hits[].data.statusstringCurrent status of the subscription (incomplete, incomplete_expired, trialing, active, past_due, canceled, unpaid, or paused).
hits[].data.tax_percentnumberThe percentage of tax applied to the subscription (deprecated, use default_tax_rates instead).
hits[].data.test_clockstringID of the test clock associated with this subscription for simulating time-based scenarios.
hits[].data.transfer_dataobjectFor Connect platforms, the account receiving funds from the subscription and optional percentage transferred.
hits[].data.trial_endnumberTimestamp indicating when the trial period ends, if applicable.
hits[].data.trial_settingsobjectSettings related to trial periods, including conditions for ending trials.
hits[].data.trial_startintegerTimestamp indicating when the trial period began, if applicable.
hits[].data.updatedintegerTimestamp indicating when the subscription was last updated.
next_cursorstring | nullCursor for next page of results
took_msnumberQuery execution time in milliseconds

Refunds

Refunds List

Returns a list of all refunds you've previously created. The refunds are returned in sorted order, with the most recent refunds appearing first.

Python SDK

await stripe.refunds.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
chargestringNoOnly return refunds for the charge specified by this charge ID
createdobjectNoOnly return customers that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
payment_intentstringNoOnly return refunds for the PaymentIntent specified by this ID
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.
Response Schema

Records

Field NameTypeDescription
idstring
object"refund"
amountinteger
balance_transactionstring | null
chargestring | null
createdinteger
currencystring
descriptionstring | null
destination_detailsobject | null
failure_balance_transactionstring | null
failure_reasonstring | null
instructions_emailstring | null
metadataobject | null
next_actionobject | null
payment_intentstring | null
pending_reasonstring | null
reasonstring | null
receipt_numberstring | null
source_transfer_reversalstring | null
statusstring | null
transfer_reversalstring | null

Meta

Field NameTypeDescription
has_moreboolean

Refunds Create

When you create a new refund, you must specify a Charge or a PaymentIntent object on which to create it. Creating a new refund will refund a charge that has previously been created but not yet refunded.

Python SDK

await stripe.refunds.create()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "refunds",
"action": "create"
}'
Response Schema

Records

Field NameTypeDescription
idstring
object"refund"
amountinteger
balance_transactionstring | null
chargestring | null
createdinteger
currencystring
descriptionstring | null
destination_detailsobject | null
failure_balance_transactionstring | null
failure_reasonstring | null
instructions_emailstring | null
metadataobject | null
next_actionobject | null
payment_intentstring | null
pending_reasonstring | null
reasonstring | null
receipt_numberstring | null
source_transfer_reversalstring | null
statusstring | null
transfer_reversalstring | null

Refunds Get

Retrieves the details of an existing refund

Python SDK

await stripe.refunds.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe refund ID
Response Schema

Records

Field NameTypeDescription
idstring
object"refund"
amountinteger
balance_transactionstring | null
chargestring | null
createdinteger
currencystring
descriptionstring | null
destination_detailsobject | null
failure_balance_transactionstring | null
failure_reasonstring | null
instructions_emailstring | null
metadataobject | null
next_actionobject | null
payment_intentstring | null
pending_reasonstring | null
reasonstring | null
receipt_numberstring | null
source_transfer_reversalstring | null
statusstring | null
transfer_reversalstring | null

Search and filter refunds 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 stripe.refunds.search(
query={"filter": {"eq": {"amount": 0}}}
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "refunds",
"action": "search",
"params": {
"query": {"filter": {"eq": {"amount": 0}}}
}
}'

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 next_cursor
fieldsarrayNoField paths to include in results

Searchable Fields

Field NameTypeDescription
amountintegerAmount refunded, in cents (the smallest currency unit).
balance_transactionstringID of the balance transaction that describes the impact of this refund on your account balance.
chargestringID of the charge that was refunded.
createdintegerTimestamp indicating when the refund was created.
currencystringThree-letter ISO currency code in lowercase representing the currency of the refund.
destination_detailsobjectDetails about the destination where the refunded funds should be sent.
idstringUnique identifier for the refund object.
metadataobjectSet of key-value pairs that you can attach to an object for storing additional structured information.
objectstringString representing the object type, always 'refund'.
payment_intentstringID of the PaymentIntent that was refunded.
reasonstringReason for the refund, either user-provided (duplicate, fraudulent, or requested_by_customer) or generated by Stripe internally (expired_uncaptured_charge).
receipt_numberstringThe transaction number that appears on email receipts sent for this refund.
source_transfer_reversalstringID of the transfer reversal that was created as a result of refunding a transfer (Connect only).
statusstringStatus of the refund (pending, requires_action, succeeded, failed, or canceled).
transfer_reversalstringID of the reversal of the transfer that funded the charge being refunded (Connect only).
updatedintegerTimestamp indicating when the refund was last updated.
Response Schema
Field NameTypeDescription
hitsarrayList of matching records
hits[].idstringRecord identifier
hits[].scorenumberRelevance score
hits[].dataobjectRecord data containing the searchable fields listed above
hits[].data.amountintegerAmount refunded, in cents (the smallest currency unit).
hits[].data.balance_transactionstringID of the balance transaction that describes the impact of this refund on your account balance.
hits[].data.chargestringID of the charge that was refunded.
hits[].data.createdintegerTimestamp indicating when the refund was created.
hits[].data.currencystringThree-letter ISO currency code in lowercase representing the currency of the refund.
hits[].data.destination_detailsobjectDetails about the destination where the refunded funds should be sent.
hits[].data.idstringUnique identifier for the refund object.
hits[].data.metadataobjectSet of key-value pairs that you can attach to an object for storing additional structured information.
hits[].data.objectstringString representing the object type, always 'refund'.
hits[].data.payment_intentstringID of the PaymentIntent that was refunded.
hits[].data.reasonstringReason for the refund, either user-provided (duplicate, fraudulent, or requested_by_customer) or generated by Stripe internally (expired_uncaptured_charge).
hits[].data.receipt_numberstringThe transaction number that appears on email receipts sent for this refund.
hits[].data.source_transfer_reversalstringID of the transfer reversal that was created as a result of refunding a transfer (Connect only).
hits[].data.statusstringStatus of the refund (pending, requires_action, succeeded, failed, or canceled).
hits[].data.transfer_reversalstringID of the reversal of the transfer that funded the charge being refunded (Connect only).
hits[].data.updatedintegerTimestamp indicating when the refund was last updated.
next_cursorstring | nullCursor for next page of results
took_msnumberQuery execution time in milliseconds

Products

Products List

Returns a list of your products. The products are returned sorted by creation date, with the most recent products appearing first.

Python SDK

await stripe.products.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
activebooleanNoOnly return products that are active or inactive
createdobjectNoOnly return products that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.
idsarray<string>NoOnly return products with the given IDs
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
shippablebooleanNoOnly return products that can be shipped
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.
urlstringNoOnly return products with the given url
Response Schema

Records

Field NameTypeDescription
idstring
object"product"
activeboolean
attributesarray<string>
createdinteger
default_pricestring | null
descriptionstring | null
featuresarray<object>
imagesarray<string>
livemodeboolean
marketing_featuresarray<object>
metadataobject
namestring
package_dimensionsobject | null
shippableboolean | null
statement_descriptorstring | null
tax_codestring | null
type"good" | "service"
unit_labelstring | null
updatedinteger
urlstring | null

Meta

Field NameTypeDescription
has_moreboolean

Products Create

Creates a new product object. Your product's name, description, and other information will be displayed in all product and invoice displays.

Python SDK

await stripe.products.create()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "products",
"action": "create"
}'
Response Schema

Records

Field NameTypeDescription
idstring
object"product"
activeboolean
attributesarray<string>
createdinteger
default_pricestring | null
descriptionstring | null
featuresarray<object>
imagesarray<string>
livemodeboolean
marketing_featuresarray<object>
metadataobject
namestring
package_dimensionsobject | null
shippableboolean | null
statement_descriptorstring | null
tax_codestring | null
type"good" | "service"
unit_labelstring | null
updatedinteger
urlstring | null

Products Get

Retrieves the details of an existing product. Supply the unique product ID and Stripe will return the corresponding product information.

Python SDK

await stripe.products.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe product ID
Response Schema

Records

Field NameTypeDescription
idstring
object"product"
activeboolean
attributesarray<string>
createdinteger
default_pricestring | null
descriptionstring | null
featuresarray<object>
imagesarray<string>
livemodeboolean
marketing_featuresarray<object>
metadataobject
namestring
package_dimensionsobject | null
shippableboolean | null
statement_descriptorstring | null
tax_codestring | null
type"good" | "service"
unit_labelstring | null
updatedinteger
urlstring | null

Products Update

Updates the specific product by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

Python SDK

await stripe.products.update(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe product ID
Response Schema

Records

Field NameTypeDescription
idstring
object"product"
activeboolean
attributesarray<string>
createdinteger
default_pricestring | null
descriptionstring | null
featuresarray<object>
imagesarray<string>
livemodeboolean
marketing_featuresarray<object>
metadataobject
namestring
package_dimensionsobject | null
shippableboolean | null
statement_descriptorstring | null
tax_codestring | null
type"good" | "service"
unit_labelstring | null
updatedinteger
urlstring | null

Products Delete

Deletes a product. Deleting a product is only possible if it has no prices associated with it.

Python SDK

await stripe.products.delete(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe product ID
Response Schema

Records

Field NameTypeDescription
idstring
object"product"
deletedboolean

Search for products using Stripe's Search Query Language.

Python SDK

await stripe.products.api_search(
query="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "products",
"action": "api_search",
"params": {
"query": "<str>"
}
}'

Parameters

Parameter NameTypeRequiredDescription
querystringYesThe search query string using Stripe's Search Query Language
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
pagestringNoA cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
Response Schema

Records

Field NameTypeDescription
idstring
object"product"
activeboolean
attributesarray<string>
createdinteger
default_pricestring | null
descriptionstring | null
featuresarray<object>
imagesarray<string>
livemodeboolean
marketing_featuresarray<object>
metadataobject
namestring
package_dimensionsobject | null
shippableboolean | null
statement_descriptorstring | null
tax_codestring | null
type"good" | "service"
unit_labelstring | null
updatedinteger
urlstring | null

Meta

Field NameTypeDescription
has_moreboolean

Balance

Balance Get

Retrieves the current account balance, based on the authentication that was used to make the request.

Python SDK

await stripe.balance.get()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "balance",
"action": "get"
}'
Response Schema

Records

Field NameTypeDescription
object"balance"
livemodeboolean
availablearray<object>
connect_reservedarray | null
instant_availablearray | null
issuingobject | null
pendingarray<object>
refund_and_dispute_prefundingobject | null

Balance Transactions

Balance Transactions List

Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transactions appearing first.

Python SDK

await stripe.balance_transactions.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
createdobjectNoOnly return transactions that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
currencystringNoOnly return transactions in a certain currency. Three-letter ISO currency code, in lowercase.
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list.
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
payoutstringNoFor automatic Stripe payouts only, only returns transactions that were paid out on the specified payout ID.
sourcestringNoOnly returns the original transaction.
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list.
typestringNoOnly returns transactions of the given type.
Response Schema

Records

Field NameTypeDescription
idstring
object"balance_transaction"
amountinteger
available_oninteger
balance_type"issuing" | "payments" | "refund_and_dispute_prefunding"
createdinteger
currencystring
descriptionstring | null
exchange_ratenumber | null
feeinteger
fee_detailsarray<object>
netinteger
reporting_categorystring
sourcestring | null
status"available" | "pending"
typestring

Meta

Field NameTypeDescription
has_moreboolean

Balance Transactions Get

Retrieves the balance transaction with the given ID.

Python SDK

await stripe.balance_transactions.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe ID of the desired balance transaction
Response Schema

Records

Field NameTypeDescription
idstring
object"balance_transaction"
amountinteger
available_oninteger
balance_type"issuing" | "payments" | "refund_and_dispute_prefunding"
createdinteger
currencystring
descriptionstring | null
exchange_ratenumber | null
feeinteger
fee_detailsarray<object>
netinteger
reporting_categorystring
sourcestring | null
status"available" | "pending"
typestring

Payment Intents

Payment Intents List

Returns a list of PaymentIntents. The payment intents are returned sorted by creation date, with the most recent payment intents appearing first.

Python SDK

await stripe.payment_intents.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
createdobjectNoOnly return payment intents that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
customerstringNoOnly return payment intents for the customer specified by this customer ID
customer_accountstringNoOnly return payment intents for the account specified by this account ID
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list.
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list.
Response Schema

Records

Field NameTypeDescription
idstring
object"payment_intent"
amountinteger
amount_capturableinteger
amount_receivedinteger
applicationstring | null
application_fee_amountinteger | null
capture_method"automatic" | "automatic_async" | "manual"
client_secretstring | null
confirmation_method"automatic" | "manual"
createdinteger
currencystring
customerstring | null
descriptionstring | null
livemodeboolean
metadataobject
payment_methodstring | null
payment_method_typesarray<string>
statusstring

Meta

Field NameTypeDescription
has_moreboolean

Payment Intents Get

Retrieves the details of a PaymentIntent that has previously been created.

Python SDK

await stripe.payment_intents.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe ID of the payment intent
Response Schema

Records

Field NameTypeDescription
idstring
object"payment_intent"
amountinteger
amount_capturableinteger
amount_receivedinteger
applicationstring | null
application_fee_amountinteger | null
capture_method"automatic" | "automatic_async" | "manual"
client_secretstring | null
confirmation_method"automatic" | "manual"
createdinteger
currencystring
customerstring | null
descriptionstring | null
livemodeboolean
metadataobject
payment_methodstring | null
payment_method_typesarray<string>
statusstring

Search for payment intents using Stripe's Search Query Language.

Python SDK

await stripe.payment_intents.api_search(
query="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"entity": "payment_intents",
"action": "api_search",
"params": {
"query": "<str>"
}
}'

Parameters

Parameter NameTypeRequiredDescription
querystringYesThe search query string using Stripe's Search Query Language
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
pagestringNoA cursor for pagination across multiple pages of results. Don't include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.
Response Schema

Records

Field NameTypeDescription
idstring
object"payment_intent"
amountinteger
amount_capturableinteger
amount_receivedinteger
applicationstring | null
application_fee_amountinteger | null
capture_method"automatic" | "automatic_async" | "manual"
client_secretstring | null
confirmation_method"automatic" | "manual"
createdinteger
currencystring
customerstring | null
descriptionstring | null
livemodeboolean
metadataobject
payment_methodstring | null
payment_method_typesarray<string>
statusstring

Meta

Field NameTypeDescription
has_moreboolean

Disputes

Disputes List

Returns a list of your disputes. The disputes are returned sorted by creation date, with the most recent disputes appearing first.

Python SDK

await stripe.disputes.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
chargestringNoOnly return disputes associated to the charge specified by this charge ID
createdobjectNoOnly return disputes that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list.
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
payment_intentstringNoOnly return disputes associated to the PaymentIntent specified by this PaymentIntent ID
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list.
Response Schema

Records

Field NameTypeDescription
idstring
object"dispute"
amountinteger
balance_transactionsarray<object>
chargestring
createdinteger
currencystring
enhanced_eligibility_typesarray<string>
evidenceobject
evidence_detailsobject
is_charge_refundableboolean
livemodeboolean
metadataobject
payment_intentstring | null
payment_method_detailsobject | null
reasonstring
statusstring

Meta

Field NameTypeDescription
has_moreboolean

Disputes Get

Retrieves the dispute with the given ID.

Python SDK

await stripe.disputes.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe ID of the dispute
Response Schema

Records

Field NameTypeDescription
idstring
object"dispute"
amountinteger
balance_transactionsarray<object>
chargestring
createdinteger
currencystring
enhanced_eligibility_typesarray<string>
evidenceobject
evidence_detailsobject
is_charge_refundableboolean
livemodeboolean
metadataobject
payment_intentstring | null
payment_method_detailsobject | null
reasonstring
statusstring

Payouts

Payouts List

Returns a list of existing payouts sent to third-party bank accounts or payouts that Stripe sent to you. The payouts return in sorted order, with the most recently created payouts appearing first.

Python SDK

await stripe.payouts.list()

API

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

Parameters

Parameter NameTypeRequiredDescription
arrival_dateobjectNoFilter payouts by expected arrival date range.
arrival_date.gtintegerNoMinimum value to filter by (exclusive)
arrival_date.gteintegerNoMinimum value to filter by (inclusive)
arrival_date.ltintegerNoMaximum value to filter by (exclusive)
arrival_date.lteintegerNoMaximum value to filter by (inclusive)
createdobjectNoOnly return payouts that were created during the given date interval.
created.gtintegerNoMinimum value to filter by (exclusive)
created.gteintegerNoMinimum value to filter by (inclusive)
created.ltintegerNoMaximum value to filter by (exclusive)
created.lteintegerNoMaximum value to filter by (inclusive)
destinationstringNoThe ID of the external account the payout was sent to.
ending_beforestringNoA cursor for use in pagination. ending_before is an object ID that defines your place in the list.
limitintegerNoA limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
starting_afterstringNoA cursor for use in pagination. starting_after is an object ID that defines your place in the list.
status"pending" | "paid" | "failed" | "canceled"NoOnly return payouts that have the given status
Response Schema

Records

Field NameTypeDescription
idstring
object"payout"
amountinteger
application_feestring | null
application_fee_amountinteger | null
arrival_dateinteger
automaticboolean
balance_transactionstring | null
createdinteger
currencystring
descriptionstring | null
destinationstring | null
failure_balance_transactionstring | null
failure_codestring | null
failure_messagestring | null
livemodeboolean
metadataobject
method"standard" | "instant"
original_payoutstring | null
payout_methodstring | null
reconciliation_statusstring
reversed_bystring | null
source_balancestring | null
source_typestring
statement_descriptorstring | null
statusstring
trace_idobject | null
typestring

Meta

Field NameTypeDescription
has_moreboolean

Payouts Get

Retrieves the details of an existing payout. Supply the unique payout ID from either a payout creation request or the payout list, and Stripe will return the corresponding payout information.

Python SDK

await stripe.payouts.get(
id="<str>"
)

API

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

Parameters

Parameter NameTypeRequiredDescription
idstringYesThe ID of the payout
Response Schema

Records

Field NameTypeDescription
idstring
object"payout"
amountinteger
application_feestring | null
application_fee_amountinteger | null
arrival_dateinteger
automaticboolean
balance_transactionstring | null
createdinteger
currencystring
descriptionstring | null
destinationstring | null
failure_balance_transactionstring | null
failure_codestring | null
failure_messagestring | null
livemodeboolean
metadataobject
method"standard" | "instant"
original_payoutstring | null
payout_methodstring | null
reconciliation_statusstring
reversed_bystring | null
source_balancestring | null
source_typestring
statement_descriptorstring | null
statusstring
trace_idobject | null
typestring