Making Requests

There are several ways to call the BigPanda APIs, and a few conventions every request follows. BigPanda does not publish language SDKs — you call the APIs directly over HTTPS.

Ways to make requests

HTTP client or curl: Make a raw HTTPS request from your code or the command line.

Export API documentation to external tools: At the bottom of each endpoint, you have options to Clone or Export the endpoint. Clone an endpoint to add it to your personal or organizational Apidog account, or Export the endpoint in several formats for import into Postman and similar tools.

MCP client: Connect an MCP-compatible AI client to the BigPanda MCP server to read incident context and take action on your behalf. Access is scoped to the calling User API Key. See the Model Context Protocol (MCP) endpoints in the API reference.

HTTP methods

BigPanda APIs use standard REST methods:

POST: Create a resource or submit data.

GET: Retrieve a resource or list.

PUT: Update an existing resource.

DELETE: Remove a resource.

Content types

Most endpoints accept and return JSON. Send Content-Type: application/json on requests with a body, and set Accept: application/json to receive JSON. A few endpoints — for example, mapping enrichment record uploads — expect a different payload format. Check the endpoint reference when in doubt.

Timestamps

Most timestamp fields use Unix epoch seconds. Do not include milliseconds unless they are explicitly mentioned in the API.

Rate limits

Each endpoint enforces its own rate limit. The specific limit for an endpoint is documented on that endpoint in the API reference. When you exceed a limit, BigPanda returns 429 Too Many Requests. Retry after the interval indicated in the response, using exponential backoff. See Rate limits and Best practices.

Next steps

Responses: Response codes and error bodies.

Pagination: Retrieve large result sets.

Asynchronous operations: Handle long-running calls.

BPQL object syntax: Filter query endpoints.

Ways to make requests#

HTTP methods#

Content types#

Timestamps#