---
cuppy_hub: salesforce
cuppy_path: reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-queryservices-statuscodes.md
cuppy_section: docs
cuppy_doc: GSVQ-8JEA
cuppy_doc_uuid: a0629772-7ecd-47c1-a04d-0e2bb5ab000d
cuppy_permalink: https://cuppy.io/salesforce/d/GSVQ-8JEA
cuppy_version: 1
cuppy_updated: 2026-10-23T16:16:52.575Z
cuppy_canonical: https://cuppy.io/salesforce/docs/reference/official/data360/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-queryservices-statuscodes
cuppy_mcp: https://cuppy.io/mcp
cuppy_body_sha256: 2d7c27061e862b1d0fc1a7e1c16d95b7bdf14da5b96bc263b887d36282fbf8f9
# cuppy_body_sha256 is over the document body ALONE, excluding both generated blocks.
---

> Mirror of <https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-queryservices-statuscodes.html> (Salesforce, Data 360 Query Guide), read 2026-10-23. Salesforce's own page is the authority; this copy exists because that site refuses non-browser readers.

## Query Services Status Codes

The Query Services APIs return standard HTTP status codes to indicate the success or failure of a request. This document provides details about the status codes and their meanings.

| Status Code | Description | Details |
| --- | --- | --- |
| 200 OK | Request successful | The request was processed successfully and the response contains the requested data. |
| 400 Bad Request | Invalid request | The request was malformed or contained invalid parameters. Check the request syntax and parameters. |
| 403 Forbidden | Authorization failed | The request failed to pass authorization. Verify your authentication credentials and permissions. |
| 404 Not Found | Resource not found | The requested resource (callback ID, verification key, or both) was not found. |
| 422 Unprocessable Entity | Invalid attribute | The attribute name used in fields/filter parameter doesn’t exist. Verify the field names in your query. |
| 429 Too Many Requests | Rate limit exceeded | Too many requests were made in a given time period. |
| 500 Server Error | Internal error | An unexpected error occurred on the server. Contact support if the issue persists. |

When an error occurs, the response includes:

*   `error`: Error message describing the issue
*   `errorCode`: Unique identifier for the error type
*   `details`: Additional information about the error (if available)

The following are examples of error code request and responses.

*   All error responses are in JSON format
*   Error messages are designed to be human-readable
*   The `errorCode` field can be used for programmatic error handling
*   Rate limits are enforced per organization

*   [Query API Documentation](https://developer.salesforce.com/docs/data/data-cloud-query-guide/references/data-cloud-query-api-reference/c360a-api-queryservices-overview.html)
*   [Data Cloud Query Guide](https://developer.salesforce.com/docs/data/data-cloud-query-guide/guide/query-guide-get-started.html)


---
<!-- cuppy -->
You are reading one file. The same content is free over MCP at https://cuppy.io/mcp with no signup: ranked search across all 376 documents in this hub, the merged view when you work in a layer, known workarounds matched to the error you hit, and depth control so you spend tokens on what you need. Start with the `_hello` tool. How to connect: https://cuppy.io/salesforce/ Something wrong in this document? Report it with the `session feedback` tool on the same endpoint.
<!-- /cuppy -->