List appointments

Use the organization gMedic account. Read-only request; provider failures are never empty results.

Scope: gmedic:appointments:read
Credentials: an API key, a client-credentials token or a person's access token
Effect: read-only; safe to retry
Limits: response up to 256 KB
CLI: arbol gmedic appointments list · MCP tool: gmedic_appointments_list

GET

https://api.getarbol.com/v1/gmedic/appointments

Authorization

Authorization
string
required
Bearer <token>, where the token is an API key, a client-credentials token or a person's access token with the scope gmedic:appointments:read. Get an API key.

Query parameters

cursor
optional
string
Opaque cursor returned by pageInfo; omit it to request the first page.
direction
optional
forward
or
backward
Direction to traverse the stable keyset ordering from the supplied cursor.

default: "forward"
limit
optional
integer
Maximum items returned in one page. Defaults to 25; larger reads require another cursor.

maximum: 100 · minimum: 1 · default: 25
agendaId
optional
string
The agenda id.

pattern: ^[1-9][0-9]{0,14}$
date
optional
string
The date.

maxLength: 20000
appointmentId
optional
string
The appointment id.

pattern: ^[1-9][0-9]{0,14}$
patientId
optional
string
The patient id.

pattern: ^[1-9][0-9]{0,14}$
pending
optional
boolean
The pending.
connectionId
optional
string
The connection id.

pattern: ^con_[0-9A-Za-z]{26}$
id
optional
string
Deprecated: use appointmentId. Answered until 2027-01-28.

pattern: ^[1-9][0-9]{0,14}$

Returns

200

Successful operation.

JSON

success
true
required
data
object
required
- data
  array of
  object
  required
  Items admitted by this resource contract within the verified organization.
  
  id
  string
  required
  pattern: ^[1-9][0-9]{0,14}$
  key
  optional
  string | null
  maxLength: 20000
  createdAt
  optional
  string | null
  maxLength: 20000
  creationDate
  deprecated
  string | null
  Deprecated: use createdAt. Answered until 2027-01-28.
  
  maxLength: 20000
  updatedAt
  optional
  string | null
  maxLength: 20000
  modificationDate
  deprecated
  string | null
  Deprecated: use updatedAt. Answered until 2027-01-28.
  
  maxLength: 20000
  title
  optional
  string | null
  maxLength: 20000
  description
  optional
  string | null
  maxLength: 20000
  allDay
  optional
  boolean | null
  block
  optional
  boolean | null
  readOnly
  optional
  boolean | null
  startsAt
  optional
  string | null
  format: date-time
  endsAt
  optional
  string | null
  format: date-time
  startDate
  deprecated
  string | null
  Deprecated: use startsAt. Answered until 2027-01-28.
  
  maxLength: 20000
  endDate
  deprecated
  string | null
  Deprecated: use endsAt. Answered until 2027-01-28.
  
  maxLength: 20000
  desiredDate
  optional
  string | null
  maxLength: 20000
  opportunityIndicator
  optional
  integer | null
  maximum: 2147483647 · minimum: -2147483648
  mainAttendantId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  mainAttendantName
  optional
  string | null
  maxLength: 20000
  mainAttendantIdentification
  optional
  string | null
  maxLength: 20000
  mainAttendantDocumentType
  optional
  object | null
  id
  string
  required
  pattern: ^[1-9][0-9]{0,14}$
  name
  optional
  string | null
  maxLength: 20000
  label
  optional
  string | null
  maxLength: 20000
  value
  optional
  string | null
  maxLength: 20000
  mainAttendantPhone
  optional
  string | null
  maxLength: 20000
  mainAttendantMobile
  optional
  string | null
  maxLength: 20000
  mainAttendantEmail
  optional
  string | null
  maxLength: 20000
  appointmentColor
  optional
  object | null
  id
  string
  required
  pattern: ^[1-9][0-9]{0,14}$
  name
  optional
  string | null
  maxLength: 20000
  label
  optional
  string | null
  maxLength: 20000
  value
  optional
  string | null
  maxLength: 20000
  status
  optional
  object | null
  id
  string
  required
  pattern: ^[1-9][0-9]{0,14}$
  name
  optional
  string | null
  maxLength: 20000
  label
  optional
  string | null
  maxLength: 20000
  value
  optional
  string | null
  maxLength: 20000
  state
  deprecated
  object | null
  Deprecated: use status. Answered until 2027-01-28.
  
  id
  string
  required
  pattern: ^[1-9][0-9]{0,14}$
  name
  optional
  string | null
  maxLength: 20000
  label
  optional
  string | null
  maxLength: 20000
  value
  optional
  string | null
  maxLength: 20000
  rejectReason
  optional
  object | null
  id
  string
  required
  pattern: ^[1-9][0-9]{0,14}$
  name
  optional
  string | null
  maxLength: 20000
  label
  optional
  string | null
  maxLength: 20000
  value
  optional
  string | null
  maxLength: 20000
  modality
  optional
  FACE_TO_FACE
  or
  VIRTUAL
  or
  HOME_VISIT
  or
  NOT_APPLICABLE
  or
  null
  videocallProvider
  optional
  string | null
  maxLength: 20000
  meetURL
  optional
  string | null
  maxLength: 20000
  agendaId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  agendaName
  optional
  string | null
  maxLength: 20000
  selfServiceAllowCancel
  optional
  boolean | null
  selfServiceAllowReschedule
  optional
  boolean | null
  branchOffice
  optional
  string | null
  maxLength: 20000
  location
  optional
  string | null
  maxLength: 20000
  service
  optional
  string | null
  maxLength: 20000
  serviceId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  authorization
  optional
  string | null
  maxLength: 20000
  medicalAuthorizationId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  authorizationSessions
  optional
  integer | null
  maximum: 9007199254740991 · minimum: 0
  currentSessions
  optional
  string | null
  maxLength: 20000
  entidad
  optional
  string | null
  maxLength: 20000
  invoice
  optional
  string | null
  maxLength: 20000
  userType
  optional
  string | null
  maxLength: 20000
  cupCode
  optional
  string | null
  maxLength: 20000
  cupName
  optional
  string | null
  maxLength: 20000
  mainDiagnosticCode
  optional
  string | null
  maxLength: 20000
  mainDiagnosticName
  optional
  string | null
  maxLength: 20000
  consultationPurposeId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  consultationPurposeCode
  optional
  string | null
  maxLength: 20000
  consultationPurposeName
  optional
  string | null
  maxLength: 20000
  externalCauseId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  externalCauseCode
  optional
  string | null
  maxLength: 20000
  externalCauseName
  optional
  string | null
  maxLength: 20000
  medicalServiceId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  medicalServiceCode
  optional
  string | null
  maxLength: 20000
  medicalServiceName
  optional
  string | null
  maxLength: 20000
  servicesGroupId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  servicesGroupCode
  optional
  string | null
  maxLength: 20000
  servicesGroupName
  optional
  string | null
  maxLength: 20000
  serviceModalityId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  serviceModalityCode
  optional
  string | null
  maxLength: 20000
  serviceModalityName
  optional
  string | null
  maxLength: 20000
  viaEntryId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  viaEntryCode
  optional
  string | null
  maxLength: 20000
  viaEntryName
  optional
  string | null
  maxLength: 20000
  userObjectId
  optional
  string | null
  pattern: ^[1-9][0-9]{0,14}$
  personCreator
  optional
  string | null
  maxLength: 20000
  date
  deprecated
  string | null
  Deprecated: use startsAt. Answered until 2027-01-28.
  
  maxLength: 20000
  time
  deprecated
  string | null
  Deprecated: use startsAt. Answered until 2027-01-28.
  
  maxLength: 20000
- object
  string
  required
  Discriminator for a resource list response.
- pageInfo
  object
  required
  Opaque navigation cursors for this page’s stable keyset order.
  
  hasNextPage
  boolean
  required
  Whether a later page exists in the current ordering.
  
  hasPreviousPage
  boolean
  required
  Whether an earlier page exists in the current ordering.
  
  nextCursor
  string | null
  required
  Opaque cursor for the next page, or null when there is none.
  
  previousCursor
  string | null
  required
  Opaque cursor for the previous page, or null when there is none.
}
error
unknown
required
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

400

INVALID_INPUT: The request does not match the published schema.

JSON

success
false
required
data
unknown
required
error
object
required
The request does not match the published schema.
- code
  INVALID_INPUT
  required
  The failure code, stable across releases.
- message
  string
  required
  What went wrong, for people; it never contains input values.
- retryable
  false
  required
  Whether repeating the same request may succeed.
- data
  object
  required
  issues
  optional
  array of
  object
  path
  string
  required
  RFC 6901 JSON Pointer to the refused field; empty for the whole input.
  
  maxLength: 256
  message
  string
  required
  maxLength: 256
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

401

UNAUTHORIZED: A valid access token is required.

JSON

success
false
required
data
unknown
required
error
object
required
A valid access token is required.
- code
  UNAUTHORIZED
  required
  The failure code, stable across releases.
- message
  string
  required
  What went wrong, for people; it never contains input values.
- retryable
  false
  required
  Whether repeating the same request may succeed.
- data
  object
  required
  No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

403

FORBIDDEN: The token does not authorize this operation.

JSON

success
false
required
data
unknown
required
error
object
required
The token does not authorize this operation.
- code
  FORBIDDEN
  required
  The failure code, stable across releases.
- message
  string
  required
  What went wrong, for people; it never contains input values.
- retryable
  false
  required
  Whether repeating the same request may succeed.
- data
  object
  required
  No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

404

CONNECTION_NOT_FOUND: This organization has no gMedic connection with this id.
RECORD_NOT_FOUND: gMedic has no record with one of the ids sent.
APPOINTMENT_NOT_FOUND: gMedic has no appointment with this id.

JSON

success
false
required
data
unknown
required
error
required
One of the following:
GmedicConnectionNotFoundFailure
CONNECTION_NOT_FOUND
code
CONNECTION_NOT_FOUND
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
false
required
Whether repeating the same request may succeed.

data
object
required
No fields.

GmedicRecordNotFoundFailure
RECORD_NOT_FOUND
code
RECORD_NOT_FOUND
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
false
required
Whether repeating the same request may succeed.

data
object
required
No fields.

GmedicAppointmentNotFoundFailure
APPOINTMENT_NOT_FOUND
code
APPOINTMENT_NOT_FOUND
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
false
required
Whether repeating the same request may succeed.

data
object
required
No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

409

NOT_CONFIGURED: This organization has no verified gMedic connection.

JSON

success
false
required
data
unknown
required
error
object
required
This organization has no verified gMedic connection.
- code
  NOT_CONFIGURED
  required
  The failure code, stable across releases.
- message
  string
  required
  What went wrong, for people; it never contains input values.
- retryable
  false
  required
  Whether repeating the same request may succeed.
- data
  object
  required
  No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

422

PROVIDER_INPUT_REJECTED: gMedic rejected the supplied fields.

JSON

success
false
required
data
unknown
required
error
object
required
gMedic rejected the supplied fields.
- code
  PROVIDER_INPUT_REJECTED
  required
  The failure code, stable across releases.
- message
  string
  required
  What went wrong, for people; it never contains input values.
- retryable
  false
  required
  Whether repeating the same request may succeed.
- data
  object
  required
  No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

429

RATE_LIMITED: The request rate limit was exceeded. Try again later.

JSON

success
false
required
data
unknown
required
error
object
required
The request rate limit was exceeded. Try again later.
- code
  RATE_LIMITED
  required
  The failure code, stable across releases.
- message
  string
  required
  What went wrong, for people; it never contains input values.
- retryable
  true
  required
  Whether repeating the same request may succeed.
- data
  object
  required
  No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

500

INTERNAL_ERROR: The service could not complete the operation.

JSON

success
false
required
data
unknown
required
error
object
required
The service could not complete the operation.
- code
  INTERNAL_ERROR
  required
  The failure code, stable across releases.
- message
  string
  required
  What went wrong, for people; it never contains input values.
- retryable
  false
  required
  Whether repeating the same request may succeed.
- data
  object
  required
  No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

502

OUTCOME_UNKNOWN: The operation may have been applied; check its result before repeating it.
PROVIDER_ACCESS_REJECTED: The configured gMedic account did not authorize this operation.
PROVIDER_RESPONSE_INVALID: gMedic returned an unexpected response.

JSON

success
false
required
data
unknown
required
error
required
One of the following:
OutcomeUnknownFailure
OUTCOME_UNKNOWN
code
OUTCOME_UNKNOWN
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
false
required
Whether repeating the same request may succeed.

data
object
required
No fields.

GmedicProviderAccessRejectedFailure
PROVIDER_ACCESS_REJECTED
code
PROVIDER_ACCESS_REJECTED
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
false
required
Whether repeating the same request may succeed.

data
object
required
No fields.

GmedicProviderResponseInvalidFailure
PROVIDER_RESPONSE_INVALID
code
PROVIDER_RESPONSE_INVALID
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
false
required
Whether repeating the same request may succeed.

data
object
required
No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

503

UPSTREAM_UNAVAILABLE: The upstream service could not complete the request.
CATALOG_SEARCH_INCOMPLETE: The service catalog search could not be completed within its limits. Service absence cannot be concluded.
PROVIDER_UNAVAILABLE: gMedic is temporarily unavailable.

JSON

success
false
required
data
unknown
required
error
required
One of the following:
UpstreamUnavailableFailure
UPSTREAM_UNAVAILABLE
code
UPSTREAM_UNAVAILABLE
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
true
required
Whether repeating the same request may succeed.

data
object
required
No fields.

GmedicCatalogSearchIncompleteFailure
CATALOG_SEARCH_INCOMPLETE
code
CATALOG_SEARCH_INCOMPLETE
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
false
required
Whether repeating the same request may succeed.

data
object
required
No fields.

GmedicProviderUnavailableFailure
PROVIDER_UNAVAILABLE
code
PROVIDER_UNAVAILABLE
required
The failure code, stable across releases.

message
string
required
What went wrong, for people; it never contains input values.

retryable
true
required
Whether repeating the same request may succeed.

data
object
required
No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}

504

UPSTREAM_TIMEOUT: The upstream service did not respond before its deadline.

JSON

success
false
required
data
unknown
required
error
object
required
The upstream service did not respond before its deadline.
- code
  UPSTREAM_TIMEOUT
  required
  The failure code, stable across releases.
- message
  string
  required
  What went wrong, for people; it never contains input values.
- retryable
  true
  required
  Whether repeating the same request may succeed.
- data
  object
  required
  No fields.
}
metadata
object
required
What every answer carries besides its data or error.
- requestId
  string
  required
  Request correlation identifier, also sent as X-Request-Id.
}