curl --request POST \
--url https://api.useautumn.com/v1/batch/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"limit": 50
}'
{
"list": [
{
"id": "John Doe",
"created_at": 1756301935674,
"name": "John Doe",
"email": "john@example.com",
"fingerprint": null,
"stripe_id": null,
"env": "sandbox",
"products": [
{
"id": "free",
"name": "free",
"group": null,
"status": "active",
"canceled_at": null,
"started_at": 1756310054931,
"is_default": true,
"is_add_on": false,
"version": 2,
"items": [
{
"type": "feature",
"feature_id": "message",
"feature_type": "single_use",
"feature": {
"id": "message",
"name": "Send Message",
"type": "single_use",
"display": {
"singular": "message",
"plural": "messages"
}
},
"included_usage": 1000,
"interval": "month",
"interval_count": 1,
"reset_usage_when_enabled": true,
"entity_feature_id": null
}
]
}
],
"features": {
"message": {
"id": "message",
"name": "Send Message",
"type": "single_use",
"unlimited": false,
"balance": 1000,
"usage": 0,
"included_usage": 1000,
"next_reset_at": 1758980335931,
"interval": "month",
"interval_count": 1,
"overage_allowed": false
}
},
"metadata": {}
},
{
"id": "John Doe",
"created_at": 1756301935674,
"name": "John Doe",
"email": "john@example.com",
"fingerprint": null,
"stripe_id": null,
"env": "sandbox",
"products": [
{
"id": "free",
"name": "free",
"group": null,
"status": "active",
"canceled_at": null,
"started_at": 1756310054931,
"is_default": true,
"is_add_on": false,
"version": 2,
"items": [
{
"type": "feature",
"feature_id": "message",
"feature_type": "single_use",
"feature": {
"id": "message",
"name": "Send Message",
"type": "single_use",
"display": {
"singular": "message",
"plural": "messages"
}
},
"included_usage": 1000,
"interval": "month",
"interval_count": 1,
"reset_usage_when_enabled": true,
"entity_feature_id": null
}
]
}
],
"features": {
"message": {
"id": "message",
"name": "Send Message",
"type": "single_use",
"unlimited": false,
"balance": 1000,
"usage": 0,
"included_usage": 1000,
"next_reset_at": 1758980335931,
"interval": "month",
"interval_count": 1,
"overage_allowed": false
}
},
"metadata": {}
}
],
"total": 1
}
Retrieve a paginated list of customers with their associated products and entitlements
curl --request POST \
--url https://api.useautumn.com/v1/batch/customers \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"limit": 50
}'
{
"list": [
{
"id": "John Doe",
"created_at": 1756301935674,
"name": "John Doe",
"email": "john@example.com",
"fingerprint": null,
"stripe_id": null,
"env": "sandbox",
"products": [
{
"id": "free",
"name": "free",
"group": null,
"status": "active",
"canceled_at": null,
"started_at": 1756310054931,
"is_default": true,
"is_add_on": false,
"version": 2,
"items": [
{
"type": "feature",
"feature_id": "message",
"feature_type": "single_use",
"feature": {
"id": "message",
"name": "Send Message",
"type": "single_use",
"display": {
"singular": "message",
"plural": "messages"
}
},
"included_usage": 1000,
"interval": "month",
"interval_count": 1,
"reset_usage_when_enabled": true,
"entity_feature_id": null
}
]
}
],
"features": {
"message": {
"id": "message",
"name": "Send Message",
"type": "single_use",
"unlimited": false,
"balance": 1000,
"usage": 0,
"included_usage": 1000,
"next_reset_at": 1758980335931,
"interval": "month",
"interval_count": 1,
"overage_allowed": false
}
},
"metadata": {}
},
{
"id": "John Doe",
"created_at": 1756301935674,
"name": "John Doe",
"email": "john@example.com",
"fingerprint": null,
"stripe_id": null,
"env": "sandbox",
"products": [
{
"id": "free",
"name": "free",
"group": null,
"status": "active",
"canceled_at": null,
"started_at": 1756310054931,
"is_default": true,
"is_add_on": false,
"version": 2,
"items": [
{
"type": "feature",
"feature_id": "message",
"feature_type": "single_use",
"feature": {
"id": "message",
"name": "Send Message",
"type": "single_use",
"display": {
"singular": "message",
"plural": "messages"
}
},
"included_usage": 1000,
"interval": "month",
"interval_count": 1,
"reset_usage_when_enabled": true,
"entity_feature_id": null
}
]
}
],
"features": {
"message": {
"id": "message",
"name": "Send Message",
"type": "single_use",
"unlimited": false,
"balance": 1000,
"usage": 0,
"included_usage": 1000,
"next_reset_at": 1758980335931,
"interval": "month",
"interval_count": 1,
"overage_allowed": false
}
},
"metadata": {}
}
],
"total": 1
}
Use your Autumn Secret Key as the Bearer token.
Successful response with paginated customer list
The response is of type object
.