API Codes

 

ON THIS PAGE      Show

 

 

 

 

About API Codes

In addition to the HTTP status codes, the error response includes a message in XML or JSON (depending on the format specified in the request).

XML Example  |  JSON Example

API Code Examples

200 Status Code

  200 - OK

 

Process the response.

 

 

 

400 Status Code

  400 - 'Specified parameter(s) {ParameterName(s)} is invalid.'

 

Check the request syntax and parameters.

 

 

 

 

  400 - 'Invalid value for parameter {ParameterName} {ParameterValue}.'

 

Check the request syntax and parameters.

 

 

 

 

  400 - 'When 'raceID' is specified, 'statePostal' is required, and multiple 'statePostal' values are not allowed.'

 

Check the request syntax and parameters.

 

 

 

401 Status Code

  401 - 'Invalid apikey'

 

Check the API key. If you have just received your key, wait for a few hours and try again. If you are still getting an error, contact us.

 

 

 

403 Status Code

  403 - 'Per-minute Quota ({QuotaLimit}) Exceeded, try again in a little bit.'

 

Wait for 5-10 seconds and try again. If you are still getting an error, contact us.

 

 

 

405 Status Code

  405 - 'Request method {MethodName} not supported'

 

Check the request method. Currently, GET is the only supported HTTP method for AP Elections API requests.

 

 

 

414 Detail Code

  414 - 'URI length exceeds 6000 characters'

 

Make sure that your request is no longer than 6,000 characters.

 

 

 

500 Status Code

  500 - 'Internal server error'

 

Contact us.

 

 

 

502 Status Code

  502 - 'Bad Gateway'

 

Contact us.

 

 

 

503 Status Code

  503 - 'Service Unavailable'

 

Contact us.

 

 

 

504 Status Code

  504 - 'Gateway Timeout'

 

Contact us.