Candidates

GET /account/noticeboard/{noticeboardPostingId}/candidates

Obtain a list of candidates in one of your castings, collaborations or another kind of noticeboard postings working with the candidates manager.

Headers

Name	Value	Required
X-Key	Your API Key
X-SessionId	Your session id
X-UserId	The logged user id to list noticeboard items from

Body

Name	Description
page	The results page to obtain. If not specified, the first page is obtained.
status	List only candidates that have been accepted for the casting/collaboration, or those who haven't yet been accepted nor declined. If not specified, the list will include both. One of the following values: accepted pending
gender	List only models of a certain gender, one of the following values: man woman nonBinary
ageMin	List only models who are at least this years old
ageMax	List only models who are at most this years old
heightMin	List only models who are at least this tall
heightMax	List only models who are at most this tall
sizeClothingMin	List only models with a minimum clothing size
sizeClothingMax	List only models with a maximum clothing size
sizeShoesMin	List only models with a minimum shoe size
sizeShoesMax	List only models with a maximum shoe size
sizeChestMin	List only models with a minimum chest size
sizeChestMax	List only models with a maximum chest size
sizeWaistMin	List only models with a minimum waist size
sizeWaistMax	List only models with a maximum waist size
sizeHipsMin	List only models with a minimum hips size
sizeHipsMax	List only models with a maximum hips sizes
eyesColor	List only models with a certain eye color. One or more of the following values, separated with commas: black brown blue green lightBrown
hairColor	List only models with a certain hair color. One or more of the following values, separated with commas: black brown blonde ginger other
hairStyle	List only models with a certain hair style. One or more of the following values, separated with commas: longStraight longCurly shortStraight shortCurly veryShort
peculiarities	List only models with certain peculiarities. One or more of the following values, separated with commas: freckles tattoos piercings dancing skating horseRiding
isPolaroids	List only models with polaroids
isReviews	List only profiles with reviews

Sizes like chest, waist, hips and heights are specified in centimeters

Clothing sizes are specified in European standard. These are the accepted values:

• For men: 40 42 44 46 48 50 52 54 56 58 60

• For women: 34 36 38 40 42 44 46 48 50 52 54 56

Shoe sizes are specified in European standard. These are the accepted values:

• For men, from 38 to 48

• For women, from 35 to 46

Example

curl \
    -G https://litmind.com/api/v1/account/noticeboard/38922/candidates \
    -H 'X-Key: bfRCu5GAEP9eMZ7fS6yvPwGxB9Nu7FzUfdnasrCkKkHAyCBZ' \
    -H 'X-SessionId: 313599f212429860887ef23ea326cc863a9186eb1a43a8f1739a1815ebe2a588' \
    -H 'X-UserId: 138829'
    -d 'status=accepted&ageMin=22&eyesColor=black,brown,lightBrown&isPolaroids=true'

Response

{
    "entity": "Candidates",
    "paging": {
        "page": 1,
        "entitiesPerPage": 10,
        "totalPages": 1,
        "totalEntities": 1,
        "entitiesThisPage": 1
    },
    "candidates": [
        {
            "entity": "Candidate",
            "id": 8492881,
            "joined": "2025-01-20T08:56:48+00:00",
            "accepted": "2025-01-20T17:03:37+00:00",
            "folder": {
                "id": 4039,
                "name": "Liked by the client"
            },
            "profile": <Profile entity>
        }
    ]
}

Name	Value
joined	The date this candidate joined
accepted	The date you accepted this candidate
folder	The folder in the candidates manager you moved this candidate into
profile	The candidate profile