List your models

Easiest: make your models in the dashboard

Open your dashboard → Models to create, preview and hide models in a few clicks — no code needed. These endpoints are here for when you want to do the same from your own system, for example to sync the list into your app or create models automatically.

GEThttps://api.catalogpro.app/businessApi/models

Gives you the models that are ready to use. Show them in your app so your user can choose who wears their clothing, then send the chosen model_id to Clothing photos.

Before you use it

You need at least one model. Make it in your dashboard under Models, or with POST /models. Models come in four groups: Men, Women, Teens (18–22) and Kids (1–17).

What to send

Header / query	Required?	What to send
`X-Api-Key`	Required	Your API key, as a header.
`gender`	Optional	`male` or `female`. Leave it out to get both.
`audience`	Optional	`adult` (the default), `kids`, or `all` for every model. Teens are adult models.
`age_range`	Optional	Only models of one age band: a Kids band such as `child_6_8`, or `teen_18_22` for Teens. A Kids band on its own selects Kids for you.

Example request

curl "https://api.catalogpro.app/businessApi/models?audience=all" \
  -H "X-Api-Key: cp_live_xxxxxxxxxxxxxxxx"

Other useful filters: ?gender=female (adult women), ?age_range=teen_18_22 (Teens), ?audience=kids&gender=male&age_range=child_3_5 (boys aged 3–5).

Example response

{
  "models": [
    {
      "model_id": "5b0e3f1c-…",    // send this as model_id when you make clothing photos
      "gender": "female",          // male or female
      "audience": "adult",         // adult (Men, Women, Teens) or kids
      "image_url": "https://…",    // a photo of the model, to show in your app
      "traits": {                  // how the model looks
        "age_range": "teen_18_22",
        "ethnicity": "indian",
        "skin_color": "medium",
        "body_type": "auto"
      },
      "created_at": 1790611200000  // when you created it (milliseconds)
    }
  ]
}

Good to know

Only ready models are listed. One you just created shows up once its job is completed.
Models you hide in the dashboard are not in this list.
Without audience, the list has adult models only (Men, Women and Teens) — older integrations keep getting what they always did.
Models don't change, so you can save this list on your side and refresh it now and then.
Model photos are never deleted.