Skip to content

model

Represents a talent / model record.

ACCESS

Directly accessible in:

Gallery Resume

Example

json
{
  "id": 123,
  "token": null,
  "name": "Sarah Jones",
  "first_name": "Sarah",
  "last_name": "Jones",
  "display_name": "S Jones",
  "gender": "female",
  "pronouns": null,
  "handle": "s-jones",
  "url": "/portfolios/s-jones",
  "current_location": null,
  "current_status": null,
  "is_traveling": 0,
  "is_in_town": 0,
  "is_terminated": 0,
  "is_published": 0,
  "profile": "<p>Sample profile</p>",
  "hair_color_id": null,
  "eye_color_id": null,
  "hair_color": null,
  "eye_color": null,
  "hair_length": null,
  "hair_type": null,
  "ethnicity": "White / Caucasian",
  "age": 30,
  "age_months": 360,
  "date_of_birth": "1995-01-31",
  "headshot_url": "https://cdn.syngency.com/[agencyId]/models/[modelId]/headshots/[imageId].jpg?[cacheString]",
  "ical_feed_url": null,
  "created_at": "2025-01-31 12:00:00",
  "updated_at": "2025-01-31 12:00:00",
  "attachments": [{
    "id": 1,
    "token": null,
    "name": "Brief",
    "ext": "pdf",
    "filename": "Brief.pdf",
    "type": "application/pdf",
    "size": "443 KB",
    "size_bytes": 453132,
    "is_published": 0,
    "key": "[agencyId]/models/[modelId]/attachments/[filename]",
    "url": "https://cdn.syngency.com/[agencyId]/models/[modelId]/attachments/[filename]?[cacheString]",
    "cdn_url": "https://cdn.syngency.com/[agencyId]/models/[modelId]/attachments/[filename]?[cacheString]",
    "timestamp": "2025-01-31 12:00:00",
    "user_name": "Jane Smith"
  }],
  "ethnicities": [{
    "id": 1,
    "name": "White / Caucasian"
  }],
  "nationalities": [{
    "id": 1,
    "name": "American"
  }],
  "divisions": [],
  "groups": [{
    "id": 1,
    "name": "Non Union"
  }],
  "measurements": [],
  "tags": [],
  "social": {
    "instagram": {},
    "tiktok": {},
    "youtube": {},
    "facebook": {},
    "twitter": {},
    "snapchat": {},
    "soundcloud": {},
    "twitch": {}
  },
  "resume": [{
    "heading": "Television",
    "items": [{
      "year": "2024",
      "production": "The Agency",
      "role": "Lead"
    }]
  }],
  "posts": [],
  "skills": [],
  "galleries": [],
  "custom_fields": []
}

Properties

id integer
token string
name string
first_name string
last_name string
display_name string
gender string
pronouns string
handle string
url string
current_location string
current_status string
is_traveling boolean
is_in_town boolean
is_terminated boolean
is_published boolean
profile string

Format: html

Bio/profile text.

hair_color_id integer
eye_color_id integer
hair_color string
eye_color string
hair_length string
hair_type string
ethnicity string

Single (first) ethnicity value for backwards compatibility. Also see array of ethnicities. Defined in Settings > Types.

age integer
age_months integer

Total age in months.

date_of_birth date
headshot_url string

Format: absolute-url

ical_feed_url string

Format: absolute-url

created_at datetime
updated_at datetime
attachments array
id integer
token string
name string
ext string
filename string
type string

MIME type.

size string

Human-readable file size.

size_bytes integer

File size in bytes.

is_published boolean
key string
url string

Format: absolute-url

cdn_url string

Format: absolute-url

timestamp datetime
user_name string

Name of the user who uploaded the attachment.

ethnicities array

Array of ethnicities types, defined in Settings > Types. Also see singular ethnicity.

id integer
name string
nationalities array
id integer
name string
divisions array

Array of divisions assigned to the model. Division types are defined in Settings > Types > Divisions.

Array of division objects.

groups array
id integer
name string
measurements array

Array of measurement objects.

tags array

Array of tag strings assigned to the model.

Item properties not defined.

social object

Social media profiles keyed by service name. Keys are only present if the model has an account for that service.

Object with keys: instagram, tiktok, youtube, facebook, twitter, snapchat, soundcloud, twitch. Each value is a social object.

resume array

Resume sections, each containing a list of credits. Available in website.model and pdf.resume contexts.

heading string
items array
year string
production string
role string
posts array

An array of posts which are attributed to the model. Available in website.model context.

Array of post objects.

skills array

An array of all model skills with a value, defined as named & categorized types via Settings > Types > Skills.

Array of skill objects.

galleries array

Array of gallery objects.

custom_fields array

Array of custom_field objects.