API Reference

Get call history for a webhook event

Lists every delivery attempt for one record, newest first, with the status code, time taken and any connection error. The list leaves out attempts that failed before Gravv made the call, such as a missing or unsafe URL. Those only add to attempts on the detail route.

GEThttps://api.gravv.xyz/v1/webhooks/calls/{id}

Path Parameters

The delivery record id from the history list. It is not the event_id in the delivered body.

Responses

Status	Description
`200`	The attempts
`400`	The request failed. An unknown ID returns `event not found or not owned by tenant`.

200 response

Attempt ID

Attempt number, starting at 1

Full URL called

Your status code. Null when no response came back.

Result of the attempt

Possible values: sent, failed

Time to the response, in milliseconds

The connection error, when there was one

{
"data": {
"calls": [
  {
    "id": "71c2e0a4-5b3d-4f6e-8a9b-0c1d2e3f4a5b",
    "attempt_number": 2,
    "request_url": "https://merchant.example.com/hooks/gravv",
    "response_status": 200,
    "status": "sent",
    "response_time_ms": 184,
    "created_at": "2026-10-13T09:11:15.330127Z",
    "error_message": null
  },
  {
    "id": "2a9f8e7d-6c5b-4a3f-9e8d-7c6b5a4f3e2d",
    "attempt_number": 1,
    "request_url": "https://merchant.example.com/hooks/gravv",
    "response_status": 500,
    "status": "failed",
    "response_time_ms": 92,
    "created_at": "2026-10-13T09:10:45.017733Z",
    "error_message": null
  }
]
},
"error": null
}

400 response

{
"data": null,
"error": "event not found or not owned by tenant"
}

Authorization

ApiKeyAuth

Was this page helpful?