Skip to main content

Stripe

Supported Entities and Actions

EntityActions
CustomersList, Get, Search
InvoicesList, Get, Search
ChargesList, Get, Search
SubscriptionsList, Get, Search
RefundsList, Get
ProductsList, Get, Search
BalanceGet
Balance TransactionsList, Get
Payment IntentsList, Get, 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

stripe.customers.list()

API

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

Params

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 Get

Retrieves a Customer object.

Python SDK

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

API

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

Params

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

Search for customers using Stripe's Search Query Language.

Python SDK

stripe.customers.search(
query="<str>"
)

API

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

Params

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

Invoices

Invoices List

Returns a list of invoices

Python SDK

stripe.invoices.list()

API

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

Params

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

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

API

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

Params

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

stripe.invoices.search(
query="<str>"
)

API

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

Params

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

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

stripe.charges.list()

API

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

Params

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

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

API

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

Params

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

stripe.charges.search(
query="<str>"
)

API

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

Params

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

Subscriptions

Subscriptions List

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

Python SDK

stripe.subscriptions.list()

API

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

Params

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

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

API

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

Params

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

stripe.subscriptions.search(
query="<str>"
)

API

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

Params

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

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

stripe.refunds.list()

API

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

Params

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 Get

Retrieves the details of an existing refund

Python SDK

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

API

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

Params

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

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

stripe.products.list()

API

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

Params

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 Get

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

Python SDK

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

API

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

Params

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

Search for products using Stripe's Search Query Language.

Python SDK

stripe.products.search(
query="<str>"
)

API

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

Params

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

stripe.balance.get()

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances/{your_connector_instance_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

stripe.balance_transactions.list()

API

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

Params

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

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

API

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

Params

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

stripe.payment_intents.list()

API

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

Params

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

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

API

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

Params

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

stripe.payment_intents.search(
query="<str>"
)

API

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

Params

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

stripe.disputes.list()

API

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

Params

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

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

API

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

Params

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

stripe.payouts.list()

API

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

Params

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

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

API

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

Params

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

Authentication

The Stripe connector supports the following authentication methods:

API Key Authentication

Field NameTypeRequiredDescription
api_keystrYesYour Stripe API Key (starts with sk_test_ or sk_live_)

Example

Python SDK

StripeConnector(
auth_config=StripeAuthConfig(
api_key="<Your Stripe API Key (starts with sk_test_ or sk_live_)>"
)
)

API

curl --location 'https://api.airbyte.ai/api/v1/connectors/instances' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
"connector_definition_id": "e094cb9a-26de-4645-8761-65c0c425d1de",
"auth_config": {
"api_key": "<Your Stripe API Key (starts with sk_test_ or sk_live_)>"
},
"name": "My Stripe Connector"
}'