List actions · Vene Docs

Lists your actions, newest first, one page at a time.

GET/v1/actions

Query parameters

patient_refstring
Only this patient's actions. Up to 255 characters.
typeenum
Only this action type.
Possible values
- pharmacy_statusIs a prescription ready.
- pharmacy_transferMove a prescription.
- pharmacy_stock_checkWho has a drug in stock.
- find_availabilityFind openings.
- book_appointmentBook a visit.
- reschedule_appointmentMove a visit.
- cancel_appointmentCancel a visit.
statusenum
Only this status.
Possible values
- queuedAccepted, not started.
- in_progressLooking up numbers or on a call.
- waiting_for_answerAsked you a question. Continues when you answer.
- waiting_for_callbackWaiting to call again, or for a place to call back.
- succeededThe place gave a definite answer.
- failedNo definite answer. See failure_reason.
- cancelledYou cancelled it.
created_aftertimestamp
Only actions created after this.
created_beforetimestamp
Only actions created before this.
limitinteger
Actions per page. 1 to 100. Defaults to 20.
cursorstring
next_cursor from the last page. Up to 256 characters.

Returns

A page of actions.

dataarray of objects
Newest first.
idstring
The action ID. Starts with act_.
typeenum
The action type.
Possible values
pharmacy_statusIs a prescription ready.
pharmacy_transferMove a prescription.
pharmacy_stock_checkWho has a drug in stock.
find_availabilityFind openings.
book_appointmentBook a visit.
reschedule_appointmentMove a visit.
cancel_appointmentCancel a visit.
statusenum
Where the action stands.
Possible values
queuedAccepted, not started.
in_progressLooking up numbers or on a call.
waiting_for_answerAsked you a question. Continues when you answer.
waiting_for_callbackWaiting to call again, or for a place to call back.
succeededThe place gave a definite answer.
failedNo definite answer. See failure_reason.
cancelledYou cancelled it.
inputobject
What you sent. Its fields depend on type; see the action types.
questionsarray of objects
Every question, oldest first.
questionstring
Up to 500 characters.
helpstring, nullable
call_idstring
Starts with call_.
typeenum
Possible values
inputFill one optional input field.
textFree text.
numberA number, within any limits.
booleanYes or no.
dateA date.
choiceOne of the offered options.
slotPick an offered opening, or send new windows.
pathstring
Up to 200 characters.
idstring
Starts with q_.
asked_attimestamp
answered_attimestamp, nullable
answerobject, nullable
valueany
unavailableenum
Possible values
true
notestring
max_lengthinteger
1 to 2,000.
integerboolean
minnumber
maxnumber
optionsarray of objects
idstring
labelstring
Up to 200 characters.
slotobject
starts_attimestamp
When the visit starts.
duration_minutesinteger
How long it runs. 1 to 1,440.
providerobject
Who the visit is with.
first_namestring
The clinician's first name. Up to 120 characters.
last_namestring
The clinician's last name. Up to 120 characters.
credentialstring
Such as MD or NP. Up to 32 characters.
npistring
The clinician's NPI. The surest way to find the office. 10 digits.
specialtystring
Such as cardiology. Up to 120 characters.
practiceobject
Where the patient is seen.
namestring
Such as Oakland Heart Center. Up to 255 characters.
addressobject
line1string
Street address. Up to 255 characters.
line2string
Suite or unit. Up to 255 characters.
citystring
Up to 120 characters.
statestring
Such as CA. Two-letter state code.
postal_codestring
Five-digit ZIP code. 5 digits.
phonestring
A hint. Vene checks the number before it dials. E.164 phone number.
locationobject
Where. Always set in results.
line1string
Street address. Up to 255 characters.
line2string
Suite or unit. Up to 255 characters.
citystring
Up to 120 characters.
statestring
Such as CA. Two-letter state code.
postal_codestring
Five-digit ZIP code. 5 digits.
held_untiltimestamp, nullable
multipleboolean
resultobject, nullable
Set when it ends. These fields are shared; the rest depend on type (action types).
summarystring
What happened, in a sentence or two. Up to 2,000 characters.
failure_reasonenum, nullable
Why it failed. Null unless failed.
Possible values
patient_authorization_requiredThe place needs the patient herself to authorize it.
place_would_not_helpThe place would not discuss it with Vene.
place_unreachableClosed, never answered, or no working number.
declined_by_youYou declined something the action needed.
fee_over_maxThe fee was over max_fee. The result names it.
internal_errorA Vene fault.
next_stepstring, nullable
What you could do next. Up to 1,000 characters.
trailarray of objects
Every call, oldest first.
idstring
The call ID. Starts with call_.
call_typeenum
Why Vene made the call.
Possible values
ask_pharmacy_fill_statusAsk a pharmacy about a fill.
ask_prescriber_to_resolve_holdAsk a prescriber's office to act on a hold.
ask_pharmacy_to_transfer_prescriptionAsk a pharmacy to pull a transfer.
ask_pharmacy_stockAsk a pharmacy about stock.
ask_provider_availabilityAsk an office about openings.
book_provider_appointmentBook with an office.
reschedule_provider_appointmentReschedule with an office.
cancel_provider_appointmentCancel with an office.
inbound_callbackA place called Vene back.
placeobject
Who was on the other end.
namestring
addressobject, nullable
line1string
Street address. Up to 255 characters.
line2string
Suite or unit. Up to 255 characters.
citystring
Up to 120 characters.
statestring
Such as CA. Two-letter state code.
postal_codestring
Five-digit ZIP code. 5 digits.
phonestring
The number dialed, or the one that called in. E.164 phone number.
started_attimestamp, nullable
When it connected.
ended_attimestamp, nullable
When it ended.
ended_reasonenum, nullable
How it ended.
Possible values
completedThe call ran to its end.
voicemailIt reached voicemail.
no_answerNobody picked up.
busyThe line was busy.
they_hung_upThe place hung up.
queue_callbackA phone queue took Vene's number to call back.
long_holdVene hung up after about ten minutes on hold.
created_attimestamp
When you created it.
updated_attimestamp
When it last changed.
ended_attimestamp, nullable
When it ended.
next_cursorstring, nullable
Pass as cursor for the next page. Null on the last.

Errors

400invalid_request
The body or query failed validation.
401unauthorized
The API key is missing, unknown, or revoked.
403forbidden
The key lacks the scope.
429rate_limited
Over a limit. Wait for Retry-After.
500internal_error
A Vene fault.

curl https://api.venehealth.com/v1/actions \
  -H "Authorization: Bearer <api_key>"

const response = await fetch('https://api.venehealth.com/v1/actions', {
  headers: {
    Authorization: 'Bearer <api_key>',
  },
})
const result = await response.json()

{
  "data": [
    {
      "id": "<action_id>",
      "type": "find_availability",
      "status": "queued",
      "input": {
        "provider": {
          "first_name": "Maya",
          "last_name": "Chen",
          "credential": "MD",
          "npi": "1992837465",
          "specialty": "cardiology"
        },
        "patient_relationship": "new",
        "reason": "Follow-up after a hospital stay for atrial fibrillation",
        "insurance_plan": {
          "payer_name": "Aetna",
          "plan_name": "Aetna Choice POS II"
        }
      },
      "questions": [],
      "result": null,
      "trail": [],
      "created_at": "2026-11-02T17:00:00.000Z",
      "updated_at": "2026-11-02T17:00:00.000Z",
      "ended_at": null
    }
  ],
  "next_cursor": null
}

{
  "error": {
    "code": "invalid_request",
    "message": "Expected a two-letter state code",
    "field": "input.pharmacy.address.state"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "A valid API key is required"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "This key lacks access to this request"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "The Vene API is not configured here"
  }
}