GSA Per Diem (Independent Publisher)
![](https://connectoricons-prod.azureedge.net/u/v-sekonda/gsaperdiem_GOVClouds/1.0.1704.3830/gsaperdiem/icon.png)
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/ |
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. |