Skip to main content

API for Per Diem Rates

The GSA Per Diem API is now available on Data.gov

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 (FY 2013 is October 1, 2012 to September 30, 2013.) GSA is responsible for setting the rates in the continental United States.  Many businesses and other organizations adopt these rates as well.

GSA is making the rates available using the Socrata Open Data API (SODA) via DATA.gov to allow software developers programmatic access the data and create innovative uses for it.

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 ZIP Code and fiscal year. Each row in the database corresponds to an individual ZIP code for a particular fiscal year.  Each row contains 12 values for the hotel reimbursement for each of the 12 months in the Fiscal Year. The meals value applies to the entire year. 

If the ZIP code is in a primary destination, then the row also contains entries for the following: City (one or more cities most prominent in that area), County, State, and the "Destination ID." The DestinationID is an arbitrary value used internally to group ZIP codes.  It is not typically presented to the general public. 

If the ZIP code is not in a primary destination, then the DestinationID is given as "0" (zero), the City value is "Standard Rate" and County is empty. The State is included along with the standard monthly hotel rates and the annual meal rate. 

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.

Use of this API is subject to Terms of Service for GSA.gov's Developer Resources.

API URL
https://explore.data.gov/resource/perdiem.[format]

Response Format
json, xml

Type
HTTP GET

Authentication
None required

Example Request

  1. Fiscal Year and Zip
    https://explore.data.gov/resource/perdiem.json?fiscalyear=2012&zip=00544

  2. Fiscal Year and County
    https://explore.data.gov/resource/perdiem.json?fiscalyear=2012&county=Suffolk

  3. Fiscal Year and Destination ID
    https://explore.data.gov/resource/perdiem.json?fiscalyear=2012&destinationid=271

  4. Fiscal Year and State
    https://explore.data.gov/resource/perdiem.json?fiscalyear=2012&state=NY
Parameter Type Description Sample Values
fiscalyear Four digit year Four digit year. Rates are set for each fiscal year beginning October 1st and end September 30th of the following year. 2012 and 2013
(These are the only years included in the API)
zip Five digit string Five digit postal ZIP code within the continental United States (including the District of Columbia) 20405,  10036
state Two letter string Two letter postal abbreviation for state NY, DC
destinationid Up to three digit integer Number used to identify a "primary destination."  This is an area for which GSA has specified a Per Diem Rate (other than the standard rate.) When the standard rate applies to a ZIP code, then DestinationID=0 0, 475
city Text string Most prominent city or cities in a primary destination. When the standard rate applies, city ="Standard Rate" "Riverhead / Ronkonkoma / Melville,"  "District of Columbia," "Standard Rate"
county Text string County in which City is located.  When the standard rate applies, county is empty. "Suffolk," "Bronx, Kings, New York, Queens, Richmond"
oct, nov, dec, jan, feb, mar, apr, may, jun, aug, sep Three letter string Month for which hotel reimbursement rate is given. Per Diem values for each month are two or three digit integers representing hotel reimbursement rate in whole dollars and zero cents. Oct, Nov, Dec, Jan, Feb, Mar, Apr, May, Jun, Aug, Sep
meals String Value represents daily total meal reimbursement allow for entire fiscal year and is a two digit integer representing whole dollars and zero cents. 46, 61

 


API