Get Freelancer Profile - OpenTrain AI

curl -sS https://app.opentrain.ai/api/public/v1/freelancers/<USER_ID_OR_SLUG> \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain freelancers get --id <USER_ID_OR_SLUG> --json

{
  "idOrSlug": "<USER_ID_OR_SLUG>"
}

{
  "freelancer": {
    "id": "<FREELANCER_ID>",
    "profileSlug": "maria-g",
    "profilePath": "/profile/maria-g",
    "displayName": "Maria G.",
    "firstName": "Maria",
    "lastNameInitial": "G",
    "talentType": "Individual",
    "title": "Text Annotation Specialist",
    "bio": "Native Spanish speaker with 4 years of NLP annotation experience.",
    "city": "Madrid",
    "countryCode": "ES",
    "country": "Spain",
    "profilePhotoUrl": "https://app.opentrain.ai/<PHOTO_PATH>",
    "hourlyRateUsd": 18,
    "availability": "FULL_TIME",
    "expertiseLevel": "EXPERT",
    "englishLevel": "FLUENT",
    "memberSince": "2024-03-02T10:00:00.000Z",
    "identityVerified": true,
    "skills": {
      "subjectMatter": ["Social media", "Customer support"],
      "tags": ["SENTIMENT_ANALYSIS", "TEXT_CLASSIFICATION"],
      "software": ["<ANNOTATION_TOOL>"],
      "dataTypes": ["TEXT"],
      "labelTypes": ["CLASSIFICATION"]
    },
    "languages": [
      { "language": "Spanish", "proficiency": "NATIVE" },
      { "language": "English", "proficiency": "FLUENT" }
    ],
    "stats": {
      "totalEarnedUsd": 2400,
      "billedHours": 310,
      "jobSuccessScore": 98,
      "reviewCount": 7,
      "averageRating": 4.9
    },
    "agency": null,
    "labelExperience": [
      {
        "id": "<EXPERIENCE_ID>",
        "title": "Spanish tweet sentiment corpus",
        "description": "Annotated 120k tweets for a sentiment model.",
        "fromYear": 2023,
        "toYear": 2025,
        "ongoing": false,
        "software": "<ANNOTATION_TOOL>",
        "dataType": "TEXT",
        "labelTypes": ["CLASSIFICATION"]
      }
    ],
    "workExperience": [],
    "education": [],
    "reviews": [
      {
        "id": "<REVIEW_ID>",
        "rating": 5,
        "comment": "Fast, precise, great guideline questions.",
        "createdAt": "2026-01-20T12:00:00.000Z"
      }
    ]
  }
}

GET

api

public

freelancers

{idOrSlug}

curl -sS https://app.opentrain.ai/api/public/v1/freelancers/<USER_ID_OR_SLUG> \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain freelancers get --id <USER_ID_OR_SLUG> --json

{
  "idOrSlug": "<USER_ID_OR_SLUG>"
}

{
  "freelancer": {
    "id": "<FREELANCER_ID>",
    "profileSlug": "maria-g",
    "profilePath": "/profile/maria-g",
    "displayName": "Maria G.",
    "firstName": "Maria",
    "lastNameInitial": "G",
    "talentType": "Individual",
    "title": "Text Annotation Specialist",
    "bio": "Native Spanish speaker with 4 years of NLP annotation experience.",
    "city": "Madrid",
    "countryCode": "ES",
    "country": "Spain",
    "profilePhotoUrl": "https://app.opentrain.ai/<PHOTO_PATH>",
    "hourlyRateUsd": 18,
    "availability": "FULL_TIME",
    "expertiseLevel": "EXPERT",
    "englishLevel": "FLUENT",
    "memberSince": "2024-03-02T10:00:00.000Z",
    "identityVerified": true,
    "skills": {
      "subjectMatter": ["Social media", "Customer support"],
      "tags": ["SENTIMENT_ANALYSIS", "TEXT_CLASSIFICATION"],
      "software": ["<ANNOTATION_TOOL>"],
      "dataTypes": ["TEXT"],
      "labelTypes": ["CLASSIFICATION"]
    },
    "languages": [
      { "language": "Spanish", "proficiency": "NATIVE" },
      { "language": "English", "proficiency": "FLUENT" }
    ],
    "stats": {
      "totalEarnedUsd": 2400,
      "billedHours": 310,
      "jobSuccessScore": 98,
      "reviewCount": 7,
      "averageRating": 4.9
    },
    "agency": null,
    "labelExperience": [
      {
        "id": "<EXPERIENCE_ID>",
        "title": "Spanish tweet sentiment corpus",
        "description": "Annotated 120k tweets for a sentiment model.",
        "fromYear": 2023,
        "toYear": 2025,
        "ongoing": false,
        "software": "<ANNOTATION_TOOL>",
        "dataType": "TEXT",
        "labelTypes": ["CLASSIFICATION"]
      }
    ],
    "workExperience": [],
    "education": [],
    "reviews": [
      {
        "id": "<REVIEW_ID>",
        "rating": 5,
        "comment": "Fast, precise, great guideline questions.",
        "createdAt": "2026-01-20T12:00:00.000Z"
      }
    ]
  }
}

Reads an AI trainer’s public profile for candidate evaluation — title, bio, skills, stats, label/work experience, education, languages, and reviews. Resolve candidates from proposals (candidate.id or candidate.profileSlug on GET /jobs/{id}/proposals), then invite or hire them. Identity is masked: first name + last initial (agencies show the agency name with no last-name initial). Personal contact details — including personal email — are never returned; see privacy. Profiles you cannot view (nonexistent, closed, banned, or restricted by the AI trainer’s visibility settings) return 404, not 403. Requirements: proposals:read scope. Works pre-claim.

Request

idOrSlug

string

required

The AI trainer’s user ID or public profile slug.

Response

freelancer

object

Hide freelancer

string

User ID.

profileSlug

string | null

Public profile slug.

profilePath

string

App-relative profile path (append to https://app.opentrain.ai).

displayName

string

Masked display name, e.g. Maria G..

firstName

string | null

First name.

lastNameInitial

string | null

Last-name initial. null for agencies.

talentType

string | null

Individual or Agency.

title

string | null

Profile headline.

bio

string | null

Profile description.

city

string | null

City.

countryCode

string | null

ISO country code.

country

string | null

Country display name.

profilePhotoUrl

string | null

Profile photo URL.

hourlyRateUsd

number | null

Listed hourly rate.

availability

string | null

Stated availability.

expertiseLevel

string | null

Self-reported expertise level.

englishLevel

string | null

English proficiency.

memberSince

string

ISO account-creation timestamp.

identityVerified

boolean

true when identity verification is complete.

skills

object

{subjectMatter[], tags[], software[], dataTypes[], labelTypes[]} — string arrays.

languages

object[]

{language, proficiency} pairs (proficiency may be null).

stats

object

{totalEarnedUsd, billedHours, jobSuccessScore, reviewCount, averageRating} — averageRating is rounded to one decimal, null when unrated.

agency

object | null

For agencies: {name, website, headcount, industryExperience[]}. null for individuals.

labelExperience

object[]

Labeling-specific experience entries: {id, title, description, fromYear, toYear, ongoing, software, dataType, labelTypes[]}.

workExperience

object[]

General work history: {id, title, company, description, fromYear, toYear, current, city, country}.

education

object[]

{id, school, degree, areaOfStudy, fromYear, toYear, description}.

reviews

object[]

Employer reviews: {id, rating, comment, createdAt} — rating rounded to one decimal, createdAt ISO.

Errors

Status	`code`	Meaning
`400`	`BAD_REQUEST`	Missing `idOrSlug`
`401`	`UNAUTHORIZED`	Missing or invalid token
`403`	`FORBIDDEN`	Missing `proposals:read` scope
`404`	`NOT_FOUND`	No such profile, or the profile is not visible to you (`details: {resource: "freelancers", idOrSlug}`)

curl -sS https://app.opentrain.ai/api/public/v1/freelancers/<USER_ID_OR_SLUG> \
  -H "Authorization: Bearer $OT_API_TOKEN"

opentrain freelancers get --id <USER_ID_OR_SLUG> --json

{
  "idOrSlug": "<USER_ID_OR_SLUG>"
}

{
  "freelancer": {
    "id": "<FREELANCER_ID>",
    "profileSlug": "maria-g",
    "profilePath": "/profile/maria-g",
    "displayName": "Maria G.",
    "firstName": "Maria",
    "lastNameInitial": "G",
    "talentType": "Individual",
    "title": "Text Annotation Specialist",
    "bio": "Native Spanish speaker with 4 years of NLP annotation experience.",
    "city": "Madrid",
    "countryCode": "ES",
    "country": "Spain",
    "profilePhotoUrl": "https://app.opentrain.ai/<PHOTO_PATH>",
    "hourlyRateUsd": 18,
    "availability": "FULL_TIME",
    "expertiseLevel": "EXPERT",
    "englishLevel": "FLUENT",
    "memberSince": "2024-03-02T10:00:00.000Z",
    "identityVerified": true,
    "skills": {
      "subjectMatter": ["Social media", "Customer support"],
      "tags": ["SENTIMENT_ANALYSIS", "TEXT_CLASSIFICATION"],
      "software": ["<ANNOTATION_TOOL>"],
      "dataTypes": ["TEXT"],
      "labelTypes": ["CLASSIFICATION"]
    },
    "languages": [
      { "language": "Spanish", "proficiency": "NATIVE" },
      { "language": "English", "proficiency": "FLUENT" }
    ],
    "stats": {
      "totalEarnedUsd": 2400,
      "billedHours": 310,
      "jobSuccessScore": 98,
      "reviewCount": 7,
      "averageRating": 4.9
    },
    "agency": null,
    "labelExperience": [
      {
        "id": "<EXPERIENCE_ID>",
        "title": "Spanish tweet sentiment corpus",
        "description": "Annotated 120k tweets for a sentiment model.",
        "fromYear": 2023,
        "toYear": 2025,
        "ongoing": false,
        "software": "<ANNOTATION_TOOL>",
        "dataType": "TEXT",
        "labelTypes": ["CLASSIFICATION"]
      }
    ],
    "workExperience": [],
    "education": [],
    "reviews": [
      {
        "id": "<REVIEW_ID>",
        "rating": 5,
        "comment": "Fast, precise, great guideline questions.",
        "createdAt": "2026-01-20T12:00:00.000Z"
      }
    ]
  }
}

Hire From Proposal

List Conversations & Read Messages

⌘I

​Request

​Response

​Errors

Request

Response

Errors