Create a bulk shipping address
curl --request POST \
--url https://b2b-api-sandbox.easyonramp.com/api/v1/cards/bulk-shipping-addresses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"line1": "123 Main Street",
"city": "Springfield",
"region": "Arizona",
"postalCode": "85001",
"countryCode": "US",
"recipientFirstName": "Jane",
"recipientLastName": "Doe",
"recipientPhoneCountryCode": "1",
"recipientPhoneNumber": "5555555555"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
line1: '123 Main Street',
city: 'Springfield',
region: 'Arizona',
postalCode: '85001',
countryCode: 'US',
recipientFirstName: 'Jane',
recipientLastName: 'Doe',
recipientPhoneCountryCode: '1',
recipientPhoneNumber: '5555555555'
})
};
fetch('https://b2b-api-sandbox.easyonramp.com/api/v1/cards/bulk-shipping-addresses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://b2b-api-sandbox.easyonramp.com/api/v1/cards/bulk-shipping-addresses"
payload = {
"line1": "123 Main Street",
"city": "Springfield",
"region": "Arizona",
"postalCode": "85001",
"countryCode": "US",
"recipientFirstName": "Jane",
"recipientLastName": "Doe",
"recipientPhoneCountryCode": "1",
"recipientPhoneNumber": "5555555555"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://b2b-api-sandbox.easyonramp.com/api/v1/cards/bulk-shipping-addresses"
payload := strings.NewReader("{\n \"line1\": \"123 Main Street\",\n \"city\": \"Springfield\",\n \"region\": \"Arizona\",\n \"postalCode\": \"85001\",\n \"countryCode\": \"US\",\n \"recipientFirstName\": \"Jane\",\n \"recipientLastName\": \"Doe\",\n \"recipientPhoneCountryCode\": \"1\",\n \"recipientPhoneNumber\": \"5555555555\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "507f1f77bcf86cd799439011",
"line1": "123 Main Street",
"city": "Springfield",
"region": "Arizona",
"postalCode": "85001",
"countryCode": "US",
"recipientFirstName": "Jane",
"recipientLastName": "Doe",
"recipientPhoneCountryCode": "1",
"recipientPhoneNumber": "5555555555",
"isDefault": true,
"line2": "Suite 4"
}Cards
Create a bulk shipping address
Creates a receiving address for bulk physical fulfilment. The first address (or one created with isDefault true) becomes the tenant default. Pass the returned id as bulkShippingGroupId when issuing physical cards.
POST
/
api
/
v1
/
cards
/
bulk-shipping-addresses
Create a bulk shipping address
curl --request POST \
--url https://b2b-api-sandbox.easyonramp.com/api/v1/cards/bulk-shipping-addresses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"line1": "123 Main Street",
"city": "Springfield",
"region": "Arizona",
"postalCode": "85001",
"countryCode": "US",
"recipientFirstName": "Jane",
"recipientLastName": "Doe",
"recipientPhoneCountryCode": "1",
"recipientPhoneNumber": "5555555555"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
line1: '123 Main Street',
city: 'Springfield',
region: 'Arizona',
postalCode: '85001',
countryCode: 'US',
recipientFirstName: 'Jane',
recipientLastName: 'Doe',
recipientPhoneCountryCode: '1',
recipientPhoneNumber: '5555555555'
})
};
fetch('https://b2b-api-sandbox.easyonramp.com/api/v1/cards/bulk-shipping-addresses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://b2b-api-sandbox.easyonramp.com/api/v1/cards/bulk-shipping-addresses"
payload = {
"line1": "123 Main Street",
"city": "Springfield",
"region": "Arizona",
"postalCode": "85001",
"countryCode": "US",
"recipientFirstName": "Jane",
"recipientLastName": "Doe",
"recipientPhoneCountryCode": "1",
"recipientPhoneNumber": "5555555555"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://b2b-api-sandbox.easyonramp.com/api/v1/cards/bulk-shipping-addresses"
payload := strings.NewReader("{\n \"line1\": \"123 Main Street\",\n \"city\": \"Springfield\",\n \"region\": \"Arizona\",\n \"postalCode\": \"85001\",\n \"countryCode\": \"US\",\n \"recipientFirstName\": \"Jane\",\n \"recipientLastName\": \"Doe\",\n \"recipientPhoneCountryCode\": \"1\",\n \"recipientPhoneNumber\": \"5555555555\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "507f1f77bcf86cd799439011",
"line1": "123 Main Street",
"city": "Springfield",
"region": "Arizona",
"postalCode": "85001",
"countryCode": "US",
"recipientFirstName": "Jane",
"recipientLastName": "Doe",
"recipientPhoneCountryCode": "1",
"recipientPhoneNumber": "5555555555",
"isDefault": true,
"line2": "Suite 4"
}Authorizations
Bearer JWT issued to your business account during onboarding
Body
application/json
Example:
"123 Main Street"
Example:
"Springfield"
Example:
"Arizona"
Example:
"85001"
Two-letter ISO country code
Example:
"US"
Example:
"Jane"
Example:
"Doe"
Dial code digits only, no plus
Example:
"1"
Example:
"5555555555"
Example:
"Suite 4"
When true, this address becomes the tenant default. The first address is default automatically.
Example:
true
Response
201 - application/json
Bulk shipping address id. Pass this as bulkShippingGroupId when issuing physical cards.
Example:
"507f1f77bcf86cd799439011"
Example:
"123 Main Street"
Example:
"Springfield"
Example:
"Arizona"
Example:
"85001"
Example:
"US"
Example:
"Jane"
Example:
"Doe"
Example:
"1"
Example:
"5555555555"
Example:
true
Example:
"Suite 4"