Dela via


GSA Per Diem (Independent Publisher)

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.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
Power Automate Premium All Power Automate regions except the following:
     -   China Cloud operated by 21Vianet
Power Apps Premium All Power Apps regions except the following:
     -   China Cloud operated by 21Vianet
Contact
Name Richard Wilson
URL https://www.richardawilson.com/
Email richard.a.wilson@microsoft.com
Connector Metadata
Publisher Richard Wilson
Website https://open.gsa.gov/api/perdiem/
Privacy policy https://www.gsa.gov/technology/government-it-initiatives/digital-strategy/terms-of-service-for-developer-resources
Categories Commerce;Finance

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
GSA API Key securestring The GSA API key which can be obtained from https://open.gsa.gov/api/perdiem True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Get per diem rates by city, state, and year

Retrieves per diem rates for a specified city, state, and fiscal year. This endpoint is ideal for users who need detailed per diem rate information for specific city and state combinations.

Get per diem rates by ZIP code and year

Fetches per diem rates based on ZIP code and fiscal year. This endpoint is particularly useful for users who want to quickly find rates in a specific geographic area identified by ZIP code.

Get per diem rates for all counties and cities, by state and year

Provides per diem rates for all counties and cities within a specified state for a given fiscal year. This is useful for users requiring a comprehensive view of rates across an entire state.

Lodging rates for the Continental US by year

Offers detailed lodging rate information for various locations within the Continental United States for the specified fiscal year.

Mapping of ZIP code to Destination-IDs and state locations

Provides a mapping of ZIP codes to their corresponding Destination-IDs and state locations for a given fiscal year.

Get per diem rates by city, state, and year

Retrieves per diem rates for a specified city, state, and fiscal year. This endpoint is ideal for users who need detailed per diem rate information for specific city and state combinations.

Parameters

Name Key Required Type Description
City
city True string

Enter the city to filter by.

State Abbreviation
state True string

Enter the two-letter abbreviation of the state.

Year
year True string

Enter the fiscal year to filter by.

Returns

Name Path Type Description
Request
request string

Identifies the request made to the API.

Errors
errors string

Contains any errors encountered during the request.

Rates
rates array of object

An array of per diem rate information for the specified location and year.

Oconus Info
rates.oconusInfo string

Provides information specific to Outside Continental United States locations.

Rate
rates.rate array of object

Contains detailed rate information for each month.

Month
rates.rate.months.month array of object

Lists individual months with corresponding rate details.

Value
rates.rate.months.month.value integer

The numerical value representing the month.

Number
rates.rate.months.month.number integer

The numerical order of the month in the year.

Short
rates.rate.months.month.short string

Short form representation of the month's name.

Long
rates.rate.months.month.long string

Full name of the month.

Meals
rates.rate.meals integer

The per diem meal rate.

Zip
rates.rate.zip string

The ZIP code for the location.

County
rates.rate.county string

The county name of the location.

City
rates.rate.city string

The city name of the location.

Standard Rate
rates.rate.standardRate string

The standard lodging rate for the location.

State
rates.state string

The state name corresponding to the rates.

Year
rates.year integer

The fiscal year for which rates are applicable.

Is Oconus
rates.isOconus string

Indicates if the location is outside the Continental United States.

Version
version string

Indicates the API version for the returned data.

Get per diem rates by ZIP code and year

Fetches per diem rates based on ZIP code and fiscal year. This endpoint is particularly useful for users who want to quickly find rates in a specific geographic area identified by ZIP code.

Parameters

Name Key Required Type Description
Zip
zip True integer

Enter the ZIP code to filter by.

Year
year True string

Enter the fiscal year to filter by.

Returns

Name Path Type Description
Request
request string

Identifies the request made to the API.

Errors
errors string

Contains any errors encountered during the request.

Rates
rates array of object

An array of per diem rate information based on the specified ZIP code and fiscal year.

Oconus Info
rates.oconusInfo string

Provides information specific to Outside Continental United States locations.

Rate
rates.rate array of object

Contains detailed rate information for each month.

Month
rates.rate.months.month array of object

Lists individual months with corresponding rate details.

Value
rates.rate.months.month.value integer

The numerical value representing the month.

Number
rates.rate.months.month.number integer

The numerical order of the month in the year.

Short
rates.rate.months.month.short string

Short form representation of the month's name.

Long
rates.rate.months.month.long string

Full name of the month.

Meals
rates.rate.meals integer

The per diem meal rate.

Zip
rates.rate.zip string

The ZIP code for the location.

County
rates.rate.county string

The county name of the location.

City
rates.rate.city string

The city name of the location.

Standard Rate
rates.rate.standardRate string

The standard lodging rate for the location.

State
rates.state string

The state name corresponding to the rates.

Year
rates.year integer

The fiscal year for which rates are applicable.

Is Oconus
rates.isOconus string

Indicates if the location is outside the Continental United States.

Version
version string

Indicates the API version for the returned data.

Get per diem rates for all counties and cities, by state and year

Provides per diem rates for all counties and cities within a specified state for a given fiscal year. This is useful for users requiring a comprehensive view of rates across an entire state.

Parameters

Name Key Required Type Description
State Abbreviation
state True string

Enter two-letter abbreviation of the state.

Year
year True string

Enter the fiscal year to filter by.

Returns

Name Path Type Description
Request
request string

Identifies the request made to the API.

Errors
errors string

Contains any errors encountered during the request.

Rates
rates array of object

An array of per diem rate information for all counties and cities within the specified state and year.

Oconus Info
rates.oconusInfo string

Provides information specific to Outside Continental United States locations.

Rate
rates.rate array of object

Contains detailed rate information for each month.

Month
rates.rate.months.month array of object

Lists individual months with corresponding rate details.

Value
rates.rate.months.month.value integer

The numerical value representing the month.

Number
rates.rate.months.month.number integer

The numerical order of the month in the year.

Short
rates.rate.months.month.short string

Short form representation of the month's name.

Long
rates.rate.months.month.long string

Full name of the month.

Meals
rates.rate.meals integer

The per diem meal rate.

Zip
rates.rate.zip string

The ZIP code for the location.

County
rates.rate.county string

The county name of the location.

City
rates.rate.city string

The city name of the location.

Standard Rate
rates.rate.standardRate string

The standard lodging rate for the location.

State
rates.state string

The state name corresponding to the rates.

Year
rates.year integer

The fiscal year for which rates are applicable.

Is Oconus
rates.isOconus string

Indicates if the location is outside the Continental United States.

Version
version string

Indicates the API version for the returned data.

Lodging rates for the Continental US by year

Offers detailed lodging rate information for various locations within the Continental United States for the specified fiscal year.

Parameters

Name Key Required Type Description
Year
year True string

Enter the fiscal year to filter by.

Returns

Name Path Type Description
array of object
January
Jan string

Lodging rates for January.

February
Feb string

Lodging rates for February.

March
Mar string

Lodging rates for March.

April
Apr string

Lodging rates for April.

May
May string

Lodging rates for May.

June
Jun string

Lodging rates for June.

July
Jul string

Lodging rates for July.

August
Aug string

Lodging rates for August.

September
Sep string

Lodging rates for September.

October
Oct string

Lodging rates for October.

November
Nov string

Lodging rates for November.

December
Dec string

Lodging rates for December.

Meals
Meals string

Per diem meal rates for the entire year.

City
City string

The city for which the rates are applicable.

State
State string

The state corresponding to the lodging rates.

County
County string

The county corresponding to the lodging rates.

Destination ID
DID string

The destination ID for the location.

Mapping of ZIP code to Destination-IDs and state locations

Provides a mapping of ZIP codes to their corresponding Destination-IDs and state locations for a given fiscal year.

Parameters

Name Key Required Type Description
Year
year True string

Enter the fiscal year to filter by.

Returns

Name Path Type Description
array of object
Zip
Zip string

The ZIP code associated with the destination ID and state.

Destination ID
DID string

The destination ID corresponding to the ZIP code.

State
ST string

The state abbreviation associated with the ZIP code.