SubAccounts

Get SubAccount

get

Retrieve information about a specific sub-account. Only available for agency and developer accounts.

Authorizations

ApiKeyAuth

apiKeystringRequired

Query parameters

apiKeystringOptional

API key for authentication

Example: 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

/subaccounts

HTTPcURLJavaScriptPython

GET /v1/subaccounts?email=name%40gmail.com 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 SubAccount

post

Create a new sub-account within your agency. Only available for agency and developer accounts.

Authorizations

ApiKeyAuth

apiKeystringRequired

Query parameters

apiKeystringOptional

API key for authentication

Example: your_api_key

Body

application/json

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

/subaccounts

HTTPcURLJavaScriptPython

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": "2026-02-03T15:23:25.916Z",
    "temporary_password": "text",
    "usage_limits": {
      "monthly_credits": 1,
      "monthly_credits_used": 1,
      "last_reset_date": "2026-02-03T15:23:25.916Z",
      "credits": 1,
      "roll_over_to_next_month": true
    }
  }
}

Delete SubAccount

delete

Delete a specific sub-account. Only available for agency and developer accounts.

Authorizations

ApiKeyAuth

apiKeystringRequired

Query parameters

apiKeystringOptional

API key for authentication

Example: 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

/subaccounts

HTTPcURLJavaScriptPython

DELETE /v1/subaccounts?email=name%40gmail.com HTTP/1.1
Host: api.dmchamp.com
Accept: */*

{
  "success": true,
  "message": "Sub-account deleted successfully"
}