List Transactions by Account (Single Currency)

Transaction Parameters

account_id

• Type: string
• Required: Yes
• Description: The specific account (currency) to query.

cursor

• Type: string
• Description: An opaque string that lets you view a consistent list of transactions.

start

• Type: date-time
• Description: Filter transactions created at or after this time. Time is in RFC 3339 format. Example: 2024-11-18T00:00:00Z

end

• Type: date-time
• Description: Filter transactions created before this time. Time is in RFC 3339 format. Example: 2024-11-18T00:00:00Z

time_field

• Type: string (enum)
• Description: Time field to filter by. Accepted values are created_date, modified_date, and attribution_date. When not specified, created_date is used as default.
  • Allowed:
    • created_date
    • modified_date
    • attribution_date

page_size

• Type: int32
• Default: 50
• Description: Number of transactions to retrieve in each request. When not specified, 50 is used as default.

country

• Type: string
• Description: Filter transactions by country. Country is in ISO 3166 Alpha-2 format (case-insensitive). Example: US

Example Request

curl https://api.usebutton.com/v1/affiliation/accounts/acc-XXX/transactions?start=2024-01-01T00:00:00Z&end=2024-01-05T00:00:00Z \  
  -X GET \  
  -u YOUR_API_KEY:  

Response Status Code

• 200: OK