Skip to content

Rippling: Retrieve a specific card transaction

Rippling restApi.getCardTransactions: arguments, response, policy and SDK examples.

← Rest API operations · Get started

Operation rippling.rest_api.get_card_transactions

Provider route: GET /card-transactions/{id}/. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/rippling with npm, or alter-sdk-rippling with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { RipplingIntegration } from "@alter-ai/rippling";
async function execute(input: Parameters<RipplingIntegration["restApi"]["getCardTransactions"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new RipplingIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.restApi.getCardTransactions(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_rippling import RipplingIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = RipplingIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.rest_api.get_card_transactions(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathobjectRequired within parentAdditional keys: not allowed
path.idstringRequired within parentFormat: id
queryobjectOptionalAdditional keys: not allowed
query.expandstringOptional

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$objectRoot
__metaobjectOptional
__meta.redacted_fieldsarrayOptional
__meta.redacted_fields[]ModelEach itemExpand Retrieve a report run — response body — meta redacted fields item
accounting_datestringOptionalDate the transaction is booked in the accounting system, as an ISO 8601 date (YYYY-MM-DD).
approval_statusstringOptionalApproval status of the transaction. `DRAFT`: not submitted for approval. `PENDING`: awaiting required information or submission before approval. `REQUESTED`: submitted and awaiting approval. `APPROVED`: approved. `REJECTED`: rejected. `FINALIZED`: finalized for payment. `ACTIONED`: payment or reimbursement completed. `CANCELLED`: cancelled. `FAILED`: payment failed. Null for card authorizations.
Known values: DRAFT, PENDING, REQUESTED, APPROVED, REJECTED, FINALIZED, ACTIONED, CANCELLED, FAILED
attachmentsarrayOptionalOther attached files, including filenames and recorded upload metadata.
attachments[]ModelEach itemExpand Retrieve a specific bill — response body — attachments item
authorization_statestringOptionalState of the card authorization. `PENDING`: an active hold awaiting completion. `CLOSED`: the authorization completed and the charge posted. `REVERSED`: the authorization was reversed and the hold released. `EXPIRED`: the hold expired without completion. Null for posted card transactions.
Known values: PENDING, CLOSED, REVERSED, EXPIRED
card_idstringOptionalID of the Finance card used. No public API is currently available to retrieve this card.
company_amountobjectOptionalAmount in the company’s headquarters currency. The `value` is a decimal string.
company_amount.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
company_amount.valueJSONOptional
company_amount.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
company_amount.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
created_atstringRequired within parentRecord creation date
entity_idstringOptionalID of the legal entity the transaction belongs to. Use it with `/company-legal-entities/{id}/`.
gl_sync_statestringOptionalState of the sync to the accounting system. `NOT_FINALIZED`: not ready for accounting review. `FOR_REVIEW`: ready for accounting review. `PENDING_SYNC`: sync is in progress. `SYNCED`: synced to the accounting system. `ERROR`: sync failed. `DO_NOT_SYNC`: marked to be excluded from sync. `EXPORTED`: exported for accounting. `NOT_SYNCABLE`: this record cannot be synced. `AUTO_SYNC`: ready to be synced automatically. Null when no sync state is set.
Known values: NOT_FINALIZED, FOR_REVIEW, PENDING_SYNC, SYNCED, ERROR, DO_NOT_SYNC, EXPORTED, NOT_SYNCABLE, AUTO_SYNC
gl_vendorobjectOptionalVendor in the connected accounting system.
gl_vendor.gl_vendor_idstringOptionalID of the vendor in the accounting system.
gl_vendor.idstringOptionalID of the accounting vendor in Rippling.
gl_vendor.namestringOptionalName of the vendor in the accounting system.
idstringRequired within parentIdentifier field
line_itemsarrayOptionalCategory splits of the transaction amount.
line_items[]ModelEach itemExpand Retrieve a specific bill — response body — line items item
memostringOptionalMemo entered on the transaction.
merchant_amountobjectOptionalAmount charged by the merchant, in the merchant currency. The `value` is a decimal string.
merchant_amount.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
merchant_amount.valueJSONOptional
merchant_amount.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
merchant_amount.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
receiptobjectOptionalReceipt file and its filename.
receipt.file_namestringOptionalOriginal file name, when recorded.
receipt.urlstringRequired within parentURL for accessing the file.
transaction_datestringOptionalWhen the purchase or authorization happened, as an ISO 8601 date-time in UTC.
transaction_typestringOptional`CARD_TRANSACTION`: a posted card charge. `CARD_AUTHORIZATION`: a hold placed by the card network before the charge posts.
Known values: CARD_TRANSACTION, CARD_AUTHORIZATION
updated_atstringRequired within parentRecord update date
vendorModelOptionalExpand Retrieve a specific card transaction — response body — vendor
vendor_idstringOptionalID of the Finance vendor. Use it with `/finance-vendors/{id}/`.
workerModelOptionalExpand Retrieve a specific card transaction — response body — worker
worker_idstringOptionalID of the worker who made the transaction. Use it with `/workers/{id}/`.

Referenced models: Retrieve a specific bill — response body — line items item, Retrieve a report run — response body — meta redacted fields item, Retrieve a specific bill — response body — attachments item, Retrieve a specific card transaction — response body — vendor, Retrieve a specific card transaction — response body — worker

26 more schemas are linked from the tables above, on the schema pages.

Retrieve a specific bill — response body — line items item
FieldTypePresenceDescription and constraints
$objectRoot
amortizedbooleanOptionalWhether this line is amortized.
amountobjectOptionalAmount of this split, in the merchant currency. The `value` is a decimal string.
amount.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
amount.valueJSONOptional
amount.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
amount.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
category_idstringOptionalID of the Finance category assigned to this split. No public API is currently available to retrieve this category; its name is in `category_name`.
category_namestringOptionalName of the finance category.
dimension_choicesobjectOptionalSelected dimension values, keyed by dimension ID. Includes department and work location.
Additional keys: see wildcard field
dimension_choices.*ModelAdditional keysExpand Retrieve a specific bill — response body — line items item dimension choices value
end_datestringOptionalEnd of the amortization period (YYYY-MM-DD).
gl_amortization_scheduleobjectOptionalERP amortization schedule associated with this line.
gl_amortization_schedule.accounting_integration_idstringOptionalRippling ID of the accounting integration that owns this object.
gl_amortization_schedule.amortization_periodJSONOptional
gl_amortization_schedule.amortization_period (anyOf 1)integerAlternativeNumber of amortization periods.
gl_amortization_schedule.amortization_period (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
gl_amortization_schedule.end_datestringOptionalEnd of the ERP amortization schedule as an ISO 8601 timestamp (for example, 2026-12-31T00:00:00). May omit a timezone offset; an omitted offset does not indicate UTC. Null when not set.
gl_amortization_schedule.gl_object_idstringOptionalObject ID in the connected accounting system.
gl_amortization_schedule.gl_object_typestringOptionalType of object in the connected accounting system: GL_AMORTIZATION_TEMPLATE defines amortization rules; GL_AMORTIZATION_SCHEDULE tracks amortization; GL_AMORTIZATION_SCHEDULE_RECURRENCE is a schedule entry; GL_ACCOUNT is a general ledger account; GL_JOURNAL_ENTRY is a journal entry; GL_POSTING_PERIOD is an accounting period; GL_VENDOR, GL_CUSTOMER, and GL_EMPLOYEE identify a vendor, customer, and employee respectively; GL_SUBSIDIARY identifies a subsidiary. Null when not set.
Known values: GL_AMORTIZATION_TEMPLATE, GL_AMORTIZATION_SCHEDULE, GL_AMORTIZATION_SCHEDULE_RECURRENCE, GL_ACCOUNT, GL_JOURNAL_ENTRY, GL_POSTING_PERIOD, GL_VENDOR, GL_CUSTOMER, GL_EMPLOYEE, GL_SUBSIDIARY
gl_amortization_schedule.namestringOptionalAccounting object name.
gl_amortization_schedule.start_datestringOptionalStart of the ERP amortization schedule as an ISO 8601 timestamp (for example, 2026-01-01T00:00:00). May omit a timezone offset; an omitted offset does not indicate UTC. Null when not set.
gl_amortization_schedule.statusstringOptionalERP amortization schedule status: NOT_STARTED means amortization has not begun; IN_PROGRESS means amortization is underway; COMPLETED means amortization is complete; ON_HOLD means amortization is paused. Null when not set.
Known values: NOT_STARTED, IN_PROGRESS, COMPLETED, ON_HOLD
gl_amortization_schedule.total_amortized_amountJSONOptional
gl_amortization_schedule.total_amortized_amount (anyOf 1)numberAlternativeAmount already amortized as reported by the ERP, in the same currency as total_amount. No currency conversion is applied; the schedule currency code is not available in this response.
gl_amortization_schedule.total_amortized_amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
gl_amortization_schedule.total_amountJSONOptional
gl_amortization_schedule.total_amount (anyOf 1)numberAlternativeTotal schedule amount as reported by the ERP, without currency conversion. The schedule currency code is not available in this response.
gl_amortization_schedule.total_amount (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
gl_amortization_templateobjectOptionalERP amortization template for this line.
gl_amortization_template.accounting_integration_idstringOptionalRippling ID of the accounting integration that owns this object.
gl_amortization_template.gl_object_idstringOptionalObject ID in the connected accounting system.
gl_amortization_template.gl_object_typestringOptionalType of object in the connected accounting system: GL_AMORTIZATION_TEMPLATE defines amortization rules; GL_AMORTIZATION_SCHEDULE tracks amortization; GL_AMORTIZATION_SCHEDULE_RECURRENCE is a schedule entry; GL_ACCOUNT is a general ledger account; GL_JOURNAL_ENTRY is a journal entry; GL_POSTING_PERIOD is an accounting period; GL_VENDOR, GL_CUSTOMER, and GL_EMPLOYEE identify a vendor, customer, and employee respectively; GL_SUBSIDIARY identifies a subsidiary. Null when not set.
Known values: GL_AMORTIZATION_TEMPLATE, GL_AMORTIZATION_SCHEDULE, GL_AMORTIZATION_SCHEDULE_RECURRENCE, GL_ACCOUNT, GL_JOURNAL_ENTRY, GL_POSTING_PERIOD, GL_VENDOR, GL_CUSTOMER, GL_EMPLOYEE, GL_SUBSIDIARY
gl_amortization_template.namestringOptionalAccounting object name.
gl_billablestringOptionalWhether this split is billed to `gl_customer` in the accounting system. `BILLABLE` means it is billed, `NOT_BILLABLE` means it is not. Null when not set.
Known values: BILLABLE, NOT_BILLABLE
gl_customerstringOptionalID of the customer record in the connected accounting integration. No public Rippling API is currently available to retrieve this accounting customer.
gl_tax_codestringOptionalRippling ID of the accounting tax code.
idstringOptionalUnique identifier of this line item. Null for older line items that have not been assigned one yet.
memostringOptionalMemo entered on this split.
prepaid_accountobjectOptionalPrepaid asset account for Rippling-managed amortization.
prepaid_account.account_idstringOptionalAccount ID in the connected accounting system.
prepaid_account.codestringOptionalAccount code.
prepaid_account.namestringOptionalAccount name.
prepaid_account.required_custom_dimensionsarrayOptionalIDs of custom dimensions required by this account.
prepaid_account.required_custom_dimensions[]stringEach item
prepaid_account.requires_departmentbooleanOptionalWhether this account requires a department.
prepaid_account.requires_work_locationbooleanOptionalWhether this account requires a work location.
prepaid_account.typestringOptionalAccounting account type: RECEIVABLE for accounts receivable, PAYABLE for accounts payable, EXPENSE for expense accounts, or BANK for bank accounts. Null when not set.
Known values: RECEIVABLE, PAYABLE, EXPENSE, BANK
start_datestringOptionalStart of the amortization period (YYYY-MM-DD).
tax_amountobjectOptionalTotal tax amount for this line in the merchant currency.
tax_amount.currency_typestringOptionalThe currency type, ex: USD, EUR, etc.
tax_amount.valueJSONOptional
tax_amount.value (anyOf 1)numberAlternativeThe decimal amount for the currency.
tax_amount.value (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Retrieve a specific bill — response body — line items item dimension choices value

Retrieve a report run — response body — meta redacted fields item
FieldTypePresenceDescription and constraints
$objectRootInfo about the redacted fields.
namestringOptionalThe name for the redacted field
reasonstringOptionalThe reason for the redaction
Retrieve a specific bill — response body — attachments item
FieldTypePresenceDescription and constraints
$objectRootA Finance transaction attachment with recorded upload details.
file_namestringOptionalOriginal file name, when recorded.
uploaded_atstringOptionalWhen the attachment was uploaded, as an ISO 8601 date-time in UTC, when recorded.
uploaded_by_idstringOptionalID of the worker who uploaded the attachment. Use it with `/workers/{id}/`.
urlstringRequired within parentURL for accessing the file.
Retrieve a specific card transaction — response body — vendor
FieldTypePresenceDescription and constraints
$objectRootVendor details. Expand with `card-transactions.read` and `finance-vendors.read`.

Expandable field
created_atstringRequired within parentRecord creation date
idstringRequired within parentIdentifier field
is_archivedbooleanOptionalWhether the vendor is archived. Archived vendors remain available for historical references.
logostringOptionalURL of the vendor's logo. Null when no logo is available.
namestringOptionalCanonical name of the Finance vendor. Name eq, ne, and in filters also match alternate names.
updated_atstringRequired within parentRecord update date
Retrieve a specific bill — response body — line items item dimension choices value
FieldTypePresenceDescription and constraints
$objectRoot
dimension_namestringOptionalName of the dimension, such as Department.
labelstringOptionalDisplay name of the selected dimension value.
valuestringOptionalID of the selected dimension value.
Retrieve a specific worker — response body — work schedule value
FieldTypePresenceDescription and constraints
$objectRootThe scheduled working hours for a day of the week.
hoursJSONOptional
hours (anyOf 1)numberAlternativeThe number of scheduled working hours for the day.
hours (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

SDK function policy ID: rippling.rest_api.get_card_transactions. Catalog operation: get-card-transactions. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Required provider scopes: ["card-transactions.read"]

Provider entitlements: ["Spend_Management_Platform_API"]

Pinned headers: {"Rippling-Api-Version": "2024-08-01"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.