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.

Back to top

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.

Loading signup form...

Back to top

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

Back to top

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

Back to top

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 .

Back to top

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 parmaters 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.

Back to top

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.

Back to top