Payments
- Transactions
- Buyers
- Checkout Sessions
- Payment links
- Payment options
- Payouts
- Refunds
- Sessions
- Settlement records
Instruments
- Card schemes
- Digital wallets
- Gift cards
- Payment methods
- Payment method definitions
Vault
- Account updater
- Network tokens
- Payment service tokens
- Vault Forward
- Vault Forward endpoints
- Vault Forward authentication
Connections
- All services
- Payment services
- Digital wallets
- Anti-fraud services
Dashboard
- Flow
- Reports
- Report executions
List buyer shipping details
Retrieve all shipping details for a buyer.
curl --request GET \
--url https://api.{gr4vy_id}.gr4vy.app/buyers/{buyer_id}/shipping-details \
--header 'Authorization: Bearer <token>'
{
"items": [
{
"type": "shipping-details",
"id": "8724fd24-5489-4a5d-90fd-0604df7d3b83",
"buyer_id": "8724fd24-5489-4a5d-90fd-0604df7d3b83",
"first_name": "John",
"last_name": "Lunn",
"email_address": "john@example.com",
"phone_number": "+1234567890",
"address": {
"city": "London",
"country": "GB",
"postal_code": "789123",
"state": "Greater London",
"state_code": "GB-LND",
"house_number_or_name": "10",
"line1": "10 Oxford Street",
"line2": "New Oxford Court",
"organization": "Gr4vy"
}
}
]
}
This endpoint requires the buyers.read
scope. The buyers.billing-details.read
scope is needed to see personally identifiable information.
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The unique ID for a buyer.
Response
A list of shipping details.
A list of shipping details.
Shipping detail for a buyer.
The type of this resource. Is always shipping-details
.
shipping-details
The unique ID for a buyer's shipping detail.
The unique ID for a buyer.
The first name(s) or given name of the buyer.
1 - 255
The last name, or family name, of the buyer.
1 - 255
The email address of the buyer.
1 - 320
The phone number of the buyer. This number is formatted according to the E164 number standard.
1 - 50
The physical shipping address associated to this buyer.
The city for the address.
1 - 100
The country for the address in ISO 3166 format.
2
The postal code or zip code for the address.
1 - 50
The state, county, or province for the address.
1 - 255
The code of state, county, or province for the address in ISO 3166-2 format.
4 - 6
The house number or name for the address. Not all payment services use this field but some do.
1 - 255
The first line of the address.
1 - 255
The second line of the address.
1 - 255
The optional name of the company or organisation to add to the address.
1 - 255
Was this page helpful?
curl --request GET \
--url https://api.{gr4vy_id}.gr4vy.app/buyers/{buyer_id}/shipping-details \
--header 'Authorization: Bearer <token>'
{
"items": [
{
"type": "shipping-details",
"id": "8724fd24-5489-4a5d-90fd-0604df7d3b83",
"buyer_id": "8724fd24-5489-4a5d-90fd-0604df7d3b83",
"first_name": "John",
"last_name": "Lunn",
"email_address": "john@example.com",
"phone_number": "+1234567890",
"address": {
"city": "London",
"country": "GB",
"postal_code": "789123",
"state": "Greater London",
"state_code": "GB-LND",
"house_number_or_name": "10",
"line1": "10 Oxford Street",
"line2": "New Oxford Court",
"organization": "Gr4vy"
}
}
]
}