API Requests
The headers, methods and URL needed to configure your API requests.
🔠 Request Headers
Every request you make to the Claimable API should include the following request headers.
| Header Name | Value | Description |
|---|---|---|
Accept | application/json | Tells the API to respond with the JSON format. The Claimable API only supports JSON. |
Authorization | Bearer {{YOUR_API_TOKEN}} | Authenticates your API request with the provided API token. |
Content-Type | application/json | When making PATCH or POST request add this header to tell the Claimable API you're sending a JSON payload. |
🔀 Methods
The Claimable API supports only the following HTTP methods to perform the corresponding operation for the given endpoint.
| HTTP Method | API Operation |
|---|---|
| GET | Fetch a resource/s. |
| POST | Create a resource. |
| PATCH | Update a resource. Accepts partial updates of only the provided attributes. |
| DELETE | Deletes a resource. |
ℹ️ URL
All API request URLs comprises three parts: API Base + Endpoint Path + Query Parameters
| URL Component | Value | Description |
|---|---|---|
| Base URL (required) | https://api.claimable.com | The base for all API requests. Must use https://. |
| Endpoint Path (required) | /{{ENDPOINT_PATH}}(e.g. /claims) | A path pointing to a supported endpoint. See the full list in the API Reference. |
| Query Parameters (optional) | ?{{PARAM}}={{VALUE}}...(e.g. s=smith) | If supported by the endpoint, you can optionally pass additional information to the API as query parameters in the request URL. |
Examples:
https://api.claimable.com/claims/12345
https://api.claimable.com/contacts
https://api.claimable.com/claims/12345/notes
What are Query Parameters
You can use query parameters to provide additional context to the API in the form of variables (key/value pairs) appended to the endpoint URL.
You should never send sensitive/private information as query parameters.
Updated about 4 years ago