Skip to main content
GET
List a person's careers

Authorizations

Authorization
string
header
required

An API key issued by a company administrator — an environment prefix (production: sdb_live_) followed by 32 characters. The prefix identifies the environment and MUST NOT be hard-coded or validated by clients; treat the whole key as opaque. Shown exactly once at creation; only a one-way hash is stored.

Scopes (granted per key on the create screen; :write never implies :read):

  • skills:read
  • skills:write
  • people:read
  • people:write
  • careers:read
  • careers:write
  • training:read
  • training:write
  • flags:read
  • flags:write
  • org:read
  • org:write
  • assessments:read
  • learning:read
  • learning:write
  • certifications:read
  • certifications:write
  • assessments:write
  • proficiency:read
  • proficiency:write
  • surveys:read
  • surveys:write
  • labels:read
  • labels:write

Path Parameters

personId
string
required

The person's email address — or the opaque person id from any response.

Example:

"ada@example.com"

Query Parameters

includePrevious
boolean
default:true

Include previous (ended) career assignments alongside current ones.

Example:

true

limit
number
default:50
Required range: 1 <= x <= 200
Example:

50

offset
number
default:0
Required range: 0 <= x <= 10000
Example:

0

Response

One page of the collection, enveloped.

data
object[]
required
meta
object
required