UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

State Codes (US)

Lookup official US state codes and names.  Lightweight API.      

Avoid input errors with a simple, reliable API that returns official US state names and state codes,  free-to-use helper endpoint for License Plate to VIN lookups.

Designed for developers, the API provides a fast and lightweight way to obtain normalised state data for you to cache or integrate anywhere you need to use it. 

Pricing

PAYG
free
Per Use
Business
free
Per Use
Enterprise
free
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)freefreefree
Business (Per Use)freefreefree
Enterprise (Per Use)freefreefree

Documentation

Introduction

Retrieve official US state names and state codes with a fast, reliable API. Easy integration for automotive app development.

Header

When making calls to our API, include the following header:

x-api-key:your-api-key-here

Example Request

https://api.oneautoapi.com/oneauto/usstatecodes

Example Sandbox Request

https://sandbox.oneautoapi.com/oneauto/usstatecodes

Request Parameters

None.

Sample Response

{
  "success": true,
  "result": [
    {
      "state_desc": "Alabama",
      "state_code": "AL"
    }
  ]
}

Response Parameters

success
e.g. true
Whether the api call was successful
state_desc
e.g. Alabama
State name.
state_code
e.g. AL
The state code.

Status Codes

200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com

Also Available From One Auto API

Company Car Tax Calculator

Calculate UK BIK and company car tax via a single API. Banded costs, personalised calculations, Scottish rates and capital contributions supported.

Insurance Rates

Provides benchmark UK vehicle insurance rates based on group, fuel type and age. Suitable for car comparisons and running cost analysis.

Lead Validation

Identify leads that require special handling and drive efficiencies in the downstream sales process. Pay on results for guaranteed ROI.

License Plate to VIN (US)

Access License Plate to VIN lookups with one API endpoint for all 50 US states, including make, model, trim decode.

MOT History & Tax Status

MOT history and current UK vehicle tax status via a single API. Combined DVLA and DVSA data by VRM - covers test results, refusals and advisories.