GET//
Use this endpoint to retrieve a specific fee charge. Include the fee transfer token path parameter to specify the fee charge to return.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | Unique identifier of the fee charge to retrieve. Allowable Values: Existing fee charge token |
Response body
| Fields | Description |
|---|---|
| business_token string Returned | Specifies the business account holder to which the fee applies. Allowable Values: 1–36 chars |
| created_time datetime Returned | Date and time when the fee_charge object was created, in UTC.Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| fees array of objects Returned | Contains attributes that define characteristics of one or more fees. Allowable Values: Array of existing fees objects |
| fees[].fee object Returned | Contains details about the fee. Allowable Values: amount, created_time, currency_code, last_modified_time, name, tags, token |
| fees[].fee.amount decimal Returned | Amount of the fee. Allowable Values: decimal Format: 0.00 |
| fees[].fee.created_time datetime Returned | Date and time when the fees object was created, in UTC.Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| fees[].fee.currency_code string Returned | Three-digit ISO 4217 currency code. Allowable Values: Valid three-digit ISO 4217 currency code |
| fees[].fee.last_modified_time datetime Returned | Date and time when the fees object was last modified, in UTC.Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| fees[].fee.name string Returned | Name of the fee. Allowable Values: 50 char max |
| fees[].fee.tags string Conditionally returned | Descriptive metadata about the fee. Allowable Values: 255 char max |
| fees[].fee.token string Returned | Unique identifier of the fees object.Allowable Values: Existing fees object token |
| fees[].memo string Conditionally returned | Additional text describing the fee. Allowable Values: 1–255 chars |
| fees[].overrideAmount decimal Conditionally returned | Dynamic fee amount that overrides the fee.amount field value.Allowable Values: decimal Format: 0.00 |
| fees[].tags string Conditionally returned | Descriptive metadata about the fee. Allowable Values: 255 char max |
| fees[].token string Returned | Unique identifier of the fee. Allowable Values: 1–36 chars |
| fees[].transaction_token string Returned | Unique identifier of the fee transaction. Allowable Values: 36 char max |
| tags string Conditionally returned | Metadata about the fee charge. This field is returned if it exists in the resource. Allowable Values: 255 char max |
| token string Returned | Unique identifier of the fee transfer. Allowable Values: 1–36 chars |
| user_token string Returned | Specifies the user account holder to which the fee applies. Allowable Values: 1–36 chars |
Sample response body
JSON
{
"fees": [
{
"token": "my_fee_01",
"memo": "Initiation fee",
"transaction_token": "162",
"fee": {
"token": "my_fee_01",
"active": true,
"name": "My Fee 01",
"amount": 1,
"tags": "My Tags",
"created_time": "2024-05-11T17:57:21Z",
"last_modified_time": "2024-05-11T17:57:21Z",
"currency_code": "USD"
}
}
],
"token": "my_feetransfer_01",
"user_token": "my_user_01",
"business_token": "my_business_01",
"created_time": "2024-05-11T19:05:55Z"
}