SubAccounts
Retrieve information about a specific sub-account. Only available for agency and developer accounts.
Query parameters
apiKeystringOptionalExample:
API key for authentication
your_api_key
emailstring ยท emailRequired
Email of the sub-account to retrieve
Responses
200
Sub-account found
application/json
400
Invalid request or not an agency account
application/json
404
Sub-account not found
application/json
500
Server error
application/json
get
GET /v1/subaccounts HTTP/1.1
Host: api.dmchamp.com
Accept: */*
{
"success": true,
"data": {
"email": "[email protected]",
"first_name": "text",
"last_name": "text",
"role": "Sub Account",
"is_agency_sub_account": true,
"business_name": "text",
"description": "text",
"address_line": "text",
"city": "text",
"country": "text",
"postal_code": "text",
"state": "text",
"time_zone_id": "text",
"language": "text",
"usage_limits": {
"monthly_credits": 1,
"monthly_credits_used": 0,
"credits": 1,
"roll_over_to_next_month": false
}
}
}
Create a new sub-account within your agency. Only available for agency and developer accounts.
Query parameters
apiKeystringOptionalExample:
API key for authentication
your_api_key
Body
emailstring ยท emailRequired
Sub-account user's email address
first_namestringRequired
Sub-account user's first name
last_namestringRequired
Sub-account user's last name
business_namestringOptional
Business name for the sub-account
descriptionstringOptional
Business description
address_linestringOptional
Business address line
citystringOptional
Business city
countrystringOptional
Business country
postal_codestringOptional
Business postal code
statestringOptional
Business state
time_zone_idstringOptional
Time zone identifier
languagestringOptional
Preferred language
Responses
201
Sub-account created successfully
application/json
400
Invalid input or insufficient credits or not an agency account
application/json
500
Server error
application/json
post
POST /v1/subaccounts HTTP/1.1
Host: api.dmchamp.com
Content-Type: application/json
Accept: */*
Content-Length: 383
{
"email": "[email protected]",
"first_name": "John",
"last_name": "Doe",
"business_name": "Sample Business",
"description": "Business description",
"address_line": "123 Main St",
"city": "Sample City",
"country": "US",
"postal_code": "12345",
"state": "CA",
"time_zone_id": "America/Los_Angeles",
"language": "en",
"usage_limits": {
"monthly_credits": 1000,
"credits": 1000,
"roll_over_to_next_month": false
}
}
{
"success": true,
"data": {
"email": "[email protected]",
"first_name": "text",
"last_name": "text",
"role": "Sub Account",
"is_agency_sub_account": true,
"uid": "text",
"created_time": "2025-07-10T01:09:22.702Z",
"temporary_password": "text",
"usage_limits": {
"monthly_credits": 1,
"monthly_credits_used": 1,
"last_reset_date": "2025-07-10T01:09:22.702Z",
"credits": 1,
"roll_over_to_next_month": true
}
}
}
Delete a specific sub-account. Only available for agency and developer accounts.
Query parameters
apiKeystringOptionalExample:
API key for authentication
your_api_key
emailstring ยท emailRequired
Email of the sub-account to delete
Responses
200
Sub-account deleted successfully
application/json
400
Invalid request or not an agency account
application/json
404
Sub-account not found
application/json
500
Server error
application/json
delete
DELETE /v1/subaccounts HTTP/1.1
Host: api.dmchamp.com
Accept: */*
{
"success": true,
"message": "Sub-account deleted successfully"
}
Was this helpful?