Response Codes

overview explore the variety of possible response codes and what they mean these error codes can be encountered in all response codes /#search and collect response codes codes received with elasticsearch dsl, search filters, and collect endpoints response codes /#bulk collect response codes codes received with bulk collect endpoints response codes /#subscriptions response codes codes received with webhook subscription endpoints search and collect response codes response code description 200 a successful request 400 r equest was unacceptable, often due to a missing required parameter the error message differs based on the error 401 no valid api key was provided check if your token is valid and try again 404 nonexistent api url using dbapi instead of cdapi in the api url while making a request will result in a 404 error message nonexistent id using a profile id that does not exist in our database, you will receive the following response 422 in correct data structure or data types are provided in the request 429 endpoint rate limit has been exceeded all api endpoints restrict the number of requests allowed per second for each client's api key find all rate limits rate limits docid\ squdqdywlhegdpyfhbzy8 500 c ode 500 denotes server issues one possible example is that the wrong request type was selected (post/get) 502 503 service is unavailable due to too many requests being received by our api bulk collect response codes response codes description 201 a successful request 202 the process is in progress 400 indicates incorrectly formatted or oversized files or invalid data 402 insufficient credits reduce your request size or contact your account manager to get more credits note error code can be received using search and collect endpoints 404 request did not find any matching ids 409 duplicate post requests were submitted 422 request exceeded the limit of 10k ids the provided urls cannot be parsed into shorthand names input does not meet the shorthand names requirements request input includes duplicates 503 b ulk collect allows yo u to download the prepared dataset as often as you like within 30 days of submitting the query after 30 days of query submission, the get query will return a 404 response code with the following message subscriptions response codes id endpoint response codes request code description 200 a successful request 400 error codes indicate failures due to incorrectly formatted or oversized files or invalid data the error message differs based on the error 401 no valid api key was provided check if your token is valid and try again 422 the webhook url you provided is invalid 5xx unable to create subscription due to a server error search filter and es dsl endpoint response codes request code description 200 a successful request 400 t he request was unacceptable, often due to a missing required parameter the error message differs based on the error 401 no valid api key was provided check if your token is valid and try again 422 there are two possible reasons for the 422 error code the webhook url you provided is invalid you have used incompatible filters (such as any date filter from search filters or es dsl schema)