Get latest Darwin heartbeat

GET

/v1/operations/heartbeat

const url = 'https://api.headcode.dev/v1/operations/heartbeat';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.headcode.dev/v1/operations/heartbeat \
  --header 'Authorization: Bearer <token>'

Returns the most recent Darwin connection heartbeat status.

Authorizations

bearerAuth

Responses

200

Latest heartbeat status.

application/json

object

received_at

required

When the heartbeat was received.

string format: date-time

status_code

required

Status code of the connection heartbeat.

string

message

Optional message associated with the heartbeat status.

string | null

Example ^generated

{
  "received_at": "2026-04-15T12:00:00Z",
  "status_code": "example",
  "message": "example"
}

401

API key is missing or invalid.

application/problem+json

Unauthorized

Authentication is missing or invalid.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/general/unauthorized

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Unauthorized

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 401

detail

required

A human-readable explanation specific to this occurrence of the problem.

string

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.GENERAL.UNAUTHORIZED

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/general/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "detail": "missing or malformed Bearer token",
  "code": "HEADCODE.GENERAL.UNAUTHORIZED"
}

403

API key does not have the required scope.

application/problem+json

Forbidden

The API key does not have the required scope.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/general/forbidden

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Forbidden

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 403

detail

required

A human-readable explanation specific to this occurrence of the problem.

string

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.GENERAL.FORBIDDEN

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/general/forbidden",
  "title": "Forbidden",
  "status": 403,
  "detail": "API key does not have the required scope 'reference:read'.",
  "code": "HEADCODE.GENERAL.FORBIDDEN"
}

404

No heartbeat data available.

application/problem+json

Heartbeat Not Found

No heartbeat data available.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/operations/heartbeat-not-found

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Heartbeat Not Found

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 404

detail

A human-readable explanation specific to this occurrence of the problem.

string

Allowed value: No heartbeat data available.

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.OPERATIONS.HEARTBEAT_NOT_FOUND

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/operations/heartbeat-not-found",
  "title": "Heartbeat Not Found",
  "status": 404,
  "detail": "No heartbeat data available.",
  "code": "HEADCODE.OPERATIONS.HEARTBEAT_NOT_FOUND"
}

429

The client has exceeded its rate limit.

application/problem+json

Too Many Requests

The client has sent too many requests in a given amount of time.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/general/rate-limited

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Too Many Requests

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 429

detail

required

A human-readable explanation specific to this occurrence of the problem.

string

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.GENERAL.RATE_LIMITED

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/general/rate-limited",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "Rate limit exceeded. Please retry after 30 seconds.",
  "code": "HEADCODE.GENERAL.RATE_LIMITED"
}

500

An unexpected internal error occurred.

application/problem+json

Internal Server Error

An internal error occurred.

object

type

required

A URI reference that identifies the problem type.

string format: uri-reference

Allowed value: https://docs.headcode.dev/errors/general/internal-server-error

title

required

A short, human-readable summary of the problem type.

string

Allowed value: Internal Server Error

status

required

The HTTP status code generated by the origin server for this occurrence.

integer

>= 100 <= 599

Allowed value: 500

detail

required

A human-readable explanation specific to this occurrence of the problem.

string

Allowed value: An internal error occurred.

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri-reference

code

required

An API-specific error code aiding consumers and the provider team understand the error based on the Headcode error taxonomy.

string

<= 100 characters

Allowed value: HEADCODE.GENERAL.INTERNAL_SERVER_ERROR

errors

Optional list of explicit details about the problem for an API consumer.

Array<object>

An object to provide explicit details on a problem towards an API consumer.

object

detail

required

A granular description on the specific error related to a body property, query parameter, path parameter, and/or header.

string

<= 4096 characters

pointer

A JSON Pointer to a specific request body property that is the source of error.

string

<= 1024 characters

parameter

The name of the query or path parameter that is the source of error.

string

<= 1024 characters

header

The name of the header that is the source of error.

string

<= 1024 characters

code

A string containing additional provider specific codes to identify the error context.

string

<= 50 characters

Example

{
  "type": "https://docs.headcode.dev/errors/general/internal-server-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An internal error occurred.",
  "code": "HEADCODE.GENERAL.INTERNAL_SERVER_ERROR"
}

Get latest Darwin heartbeat

Authorizations

Responses

200

Example generated

401

Example

403

Example

404

Example

429

Example

500

Example

Example ^generated