Elections API Help Center
Click here to see this page in full context
 
  1. Home  >  
  2. Elections API Help Center >
  3. Developer Guide >
  4. API Codes
 
 

API Codes

 
ON THIS PAGE          HideON THIS PAGE          Show
  1. About API Codes
  2. API Code Examples
    1. 200 Status Code
    2. 400 Status Code
    3. 401 Status Code
    4. 403 Status Code
    5. 405 Status Code
    6. 414 Detail Code
    7. 500 Status Code
    8. 502 Status Code
    9. 503 Status Code
    10. 504 Status Code

 

 

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.

 

 

 
 

 

 

 

 

If you still require additional assistance, please contact AP Customer Support.

For current system status or system maintenance information, please visit the AP Customer Zone website.

 

 

 
 

 

 

 

THE ASSOCIATED PRESS

© copyright 2025  Associated Press. All rights reserved.