Get opportunity
Returns one opportunity with its stage, tags, sources, followers and archive state.
GET https://cotlet.dev/api/v1/lever/opportunities/{opportunity_id}
read
Returns the profile fields Lever shows on the opportunity: contact name, emails, headline, stage, posting, owner, tags, sources, followers and the link to the profile. For an archived opportunity it also returns the archive reason and date. Notes and feedback come from list_notes and list_feedback.
Parameters
| Name | Type | Description |
|---|---|---|
| opportunity_id string required | string | Opportunity ID from list_opportunities. |
Request
curl https://cotlet.dev/api/v1/lever/opportunities/opportunity_8c41d2 \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("lever", "get_opportunity", {"opportunity_id":"opportunity_8c41d2"})const result = await cotlet.call('lever', 'get_opportunity', {"opportunity_id":"opportunity_8c41d2"});cotlet call lever get_opportunity --data '{"opportunity_id":"opportunity_8c41d2"}'Example response
{
"opportunity_id": "5c3d8a17-e2b4-49f6-8d01-7a9b6c4e2f05",
"name": "Aisha Khan",
"headline": "UX lead at Brightly",
"emails": [
"aisha.khan@example.com"
],
"stage": "Recruiter screen",
"posting": "Senior Designer",
"owner": "Jordan Pike",
"tags": [
"portfolio-strong"
],
"sources": [
"Referral"
],
"followers": [
"Jordan Pike",
"Sam Okafor"
],
"archived": null,
"url": "https://hire.lever.co/candidates/5c3d8a17-e2b4-49f6-8d01-7a9b6c4e2f05"
}