Overview
Per Diem Rates are the allowed reimbursement rates for hotel stays and meals for federal travelers. Rates are set for each of the federal government’s fiscal years (October 1st to September 30th) GSA is responsible for setting the rates in the continental United States. Many businesses and other organizations adopt these rates as well. This API provides access to the current rate information.
Use of this API is subject to Terms of Service for GSA.gov’s Developer Resources.
Getting Started
To begin using this API, you will need to register for an API Key. You can sign up for an API key below. After registration, you will need to provide this API key in the x-api-key
HTTP header with every API request.
Rate Limits
The default rate limit is 1,000 hits per hour. If you need to request a rate limit change, please email us at ocmweb@gsa.gov
OpenAPI Specification File
You can view the full details of this API in the OpenAPI Specification file available here: Open API specification file for the Sample API
API Description
This API has five primary endpoints:
Endpoint 1: https://api.gsa.gov/travel/perdiem/v2/rates/city/{city}/state/{ST}/year/{year}
Description: Rates by city/state/year
Example: https://api.gsa.gov/travel/perdiem/v2/rates/city/Fairfax/state/VA/year/2019
Query Parameters
Name | Description | Example |
---|---|---|
city | Destination city | Fairfax |
state | Destination state | VA |
year | Fiscal year of travel. Available back to 2010. | 2019 |
Expected Result
Name | Description |
---|---|
meals | Meal rates per day, in dollars |
value | Lodging rates per day, in dollars |
Endpoint 2: https://api.gsa.gov/travel/perdiem/v2/rates/state/{ST}/year/{year}
Description: Rates by state/year
Example: https://api.gsa.gov/travel/perdiem/v2/rates/state/VA/year/2019
Query Parameters
Name | Description | Example |
---|---|---|
state | Destination state | VA |
year | Fiscal year of travel. Available back to 2010. | 2019 |
Expected Result
Name | Description |
---|---|
meals | Meal rates per day, in dollars |
value | Lodging rates per day, in dollars |
Endpoint 3: https://api.gsa.gov/travel/perdiem/v2/rates/zip/{zip}/year/{year}
Description: Rates by zip/year
Example: https://api.gsa.gov/travel/perdiem/v2/rates/zip/20171/year/2019
Query Parameters
Name | Description | Example |
---|---|---|
zip | Destination zip code | 20171 |
year | Fiscal year of travel. Available back to 2010. | 2019 |
Expected Result
Name | Description |
---|---|
meals | Meal rates per day, in dollars |
value | Lodging rates per day, in dollars |
Endpoint 4: https://api.gsa.gov/travel/perdiem/v2/rates/conus/lodging/{year}
Description: Lodging Rates for the Continental U.S. by Year
Example: https://api.gsa.gov/travel/perdiem/v2/rates/conus/lodging/2019
Query Parameters
Name | Description | Example |
---|---|---|
year | Fiscal year of travel. Available back to 2010. | 2019 |
Expected Result
Name | Description |
---|---|
meals | Meal rates per day, in dollars |
DID | Destination ID; a unique ID for the city and state pair |
Endpoint 5: https://api.gsa.gov/travel/perdiem/v2/rates/conus/mie/{year}
Description: Meals and Incidental Expense (M&IE) Breakdown Rates by Year
Example: https://api.gsa.gov/travel/perdiem/v2/rates/conus/mie/2019
Query Parameters
Name | Description | Example |
---|---|---|
year | Fiscal year of travel. Available back to 2010. | 2019 |
Expected Result
Name | Description |
---|---|
total | Total PerDiem |
breakfast | PerDiem for breakfast |
lunch | PerDiem for lunch |
dinner | PerDiem for dinner |
incidental | PerDiem for incidents |
FirstLastDay | PerDiem for the first and last day |
Endpoint 6: https://api.gsa.gov/travel/perdiem/v2/rates/conus/zipcodes/{year}
Description: Mapping of Destination-IDs to ZipCode and State locations
Example: https://api.gsa.gov/travel/perdiem/v2/rates/conus/zipcodes/2019
Query Parameters
Name | Description | Example |
---|---|---|
year | Fiscal year of travel. Available back to 2010. | 2019 |
Expected Result
Name | Description |
---|---|
DID | A destination-ID |
Zip | The ZipCode this destination-ID resides within |
ST | The state this destination-ID resides within |
About Per Diem Rates
GSA sets rates for geographic areas it determines called “primary destinations.” Areas outside the primary destinations are covered by the same, nation-wide “standard rate.” The Per Diem Rate database is organized by location and fiscal year. The meals value applies to the entire year.
On the first and last days of a trip, the allowed meal reimbursement is 75% of the Per Diem Rate.
For more details on Per Diem Rates please consult the Federal Travel Regulations .
HTTP Response Codes
The API will return one of the following responses:
HTTP Response Code | Description |
---|---|
200 | Successful. Data will be returned in JSON format. |
400 | Bad request. Verify the query string parameters that were provided. |
403 | API key is not correct or was not provided. |
4XX | Additional 400-level are caused by some type of error in the information submitted. |
Contact Us
If you have questions or need help, please email us at ocmweb@gsa.gov or file an issue in this GitHub issue tracker.