Allowances API MCP Server

Get DTMO CONUS locations # todo add filter by location Return all DTMO locations for a specific state using its US State Code (e.g., 'US-CA')

Get DTMO OCONUS locations Return DTMO locations for a specific country using its ISO Code (e.g., 'AU', 'BE'). The optional `location` filter performs case-insensitive substring matching. Omitted or empty filters return all locations in the country. Nonempty input is literal, including spaces and wildcard characters. No matches returns [].

Get perdiem CONUS Department of Defense per diem for the continental U.S. by state code (e.g. 'TX'); Alaska, Hawaii and the territories are served by the OCONUS endpoint. Returns lodging, local and proportional meal rates, incidentals and the maximum per diem (lodging + meals + incidentals) per season. `q` filters by location name. `date` selects the rates in force on that day, `year` a fiscal year (Oct 1 to Sep 30); omit both for the current fiscal year.

Get perdiem OCONUS Department of Defense per diem outside the continental U.S.: foreign countries by ISO alpha-2 code (e.g. 'PG'), and Alaska, Hawaii and U.S. territories by 'US-XX' code. Returns lodging, local and proportional meal rates, incidentals and the maximum per diem (lodging + meals + incidentals) per season. `q` filters by location name. `date` selects the rates in force on that day, `year` a fiscal year (Oct 1 to Sep 30); omit both for the current fiscal year.

Search by location name Department of Defense per diem by location name (e.g. 'Kabul') or country/state name (e.g. 'Afghanistan'), across CONUS and OCONUS. `date` selects the rates in force on that day, `year` a fiscal year (Oct 1 to Sep 30); omit both for the current fiscal year.

GSA per diem rate by destination Return the GSA per diem rate in effect for a specific GSA destination on a given date. A destination is a rate area defined by GSA and may represent a city, metropolitan area, county, or the Standard CONUS area. It is not necessarily a single municipality. `destination_id` is the numeric identifier assigned to that GSA rate area in the source data. Use [`GET /v1/gsa/destinations`](/docs#tag/GSA---CONUS-locations/operation/get_destinations_v1_gsa_destinations_get) to browse the available destinations and find the ID for the location you need. Destination ID `0` represents the Standard CONUS rate. The response contains the seasonal lodging rate applicable on the requested date and the daily meals and incidental expenses (M&IE) rate. When `date` is omitted, today's rate is returned. Set `verification_url=true` to include the corresponding official GSA lookup URL.

GSA per diem rates by state and date Return every GSA destination rate in a state that applies on a specific date. Each result contains the seasonal lodging rate in effect on that date and the daily meals and incidental expenses (M&IE) rate. When `date` is omitted, today's rates are returned. Use the optional `location` parameter to filter by a GSA destination or location-defined name. Matching is case-insensitive and accepts partial names. If the state has no non-standard destination rate, the Standard CONUS rate is returned. This endpoint covers GSA CONUS rates; unsupported or unknown state codes return 404. Set `verification_url=true` to include the corresponding official GSA state lookup URL.

GSA per diem rates by state and fiscal year Return every GSA destination rate in a state for a US fiscal year. Each result contains the lodging rate for every month and the daily meals and incidental expenses (M&IE) rate. A US fiscal year begins October 1 of the preceding calendar year and ends September 30. Use the optional `location` parameter to filter destinations by their GSA destination or location-defined name. Matching is case-insensitive and accepts partial names. Set `verification_url=true` to include the corresponding official GSA state lookup URL.

GSA per diem rates by ZIP code and date Return every GSA destination rate associated with a US ZIP code that applies on a specific date. Each result contains the seasonal lodging rate in effect on that date and the daily meals and incidental expenses (M&IE) rate. When `date` is omitted, today's rates are returned. A ZIP code can map to more than one GSA destination. When that happens, `results` contains every applicable rate, and the API does not choose one automatically. Use the returned county or a geocoder to determine which destination applies to the travel location. If a known ZIP code has no non-standard destination, the Standard CONUS rate is returned. The path accepts either a five-digit ZIP code or ZIP+4. ZIP+4 values are normalized to their first five digits. Set `verification_url=true` to include the corresponding official GSA lookup URL.

GSA per diem rates by ZIP code and fiscal year Return the GSA lodging rates for every month of a US fiscal year and the daily meals and incidental expenses (M&IE) rate associated with a ZIP code. A US fiscal year begins October 1 of the preceding calendar year and ends September 30. A ZIP code can map to more than one GSA destination. When that happens, `results` contains every applicable rate. The API does not choose a destination automatically; use the returned county or a geocoder to determine which rate applies. ZIP codes without a non-standard destination return the Standard CONUS rate. ZIP+4 input is accepted and normalized to its first five digits. Set `verification_url=true` to include the corresponding official GSA lookup URL.

FEMA-listed property by FEMA ID Return the property registered under a FEMA ID, or 404 when the ID is not on the list. The Hotel and Motel Fire Safety Act of 1990 requires federal travelers to stay at a property on FEMA's Hotel and Motel National Master List to be reimbursed for lodging. Each property on the list has a FEMA ID. FEMA publishes the current list only; `as_of` is the date of the snapshot the results come from. This endpoint returns no rates: combine it with the GSA per diem lookups for the lodging ceiling.

FEMA-listed properties by state, optionally filtered by city Return the properties on the list in a state, ordered by city then name and paginated with `offset` and `limit` (50 by default, 200 at most); `total` is the number of matches across all pages. The optional `city` is matched case-insensitively as a partial name, so `york` matches New York and Yorktown. The state path accepts the 50 states, DC and the territories FEMA lists (AS, GU, MP, PR, PW, VI); other codes return 404. A city that matches nothing returns an empty `results` list. The Hotel and Motel Fire Safety Act of 1990 requires federal travelers to stay at a property on FEMA's Hotel and Motel National Master List to be reimbursed for lodging. Each property on the list has a FEMA ID. FEMA publishes the current list only; `as_of` is the date of the snapshot the results come from. This endpoint returns no rates: combine it with the GSA per diem lookups for the lodging ceiling.

FEMA-listed properties by ZIP code Return every property on the list in a US ZIP code, ordered by name. The path accepts a five-digit ZIP or ZIP+4, normalized to the first five digits. A known ZIP with no listed property returns an empty `results` list; an unknown ZIP returns 404. The Hotel and Motel Fire Safety Act of 1990 requires federal travelers to stay at a property on FEMA's Hotel and Motel National Master List to be reimbursed for lodging. Each property on the list has a FEMA ID. FEMA publishes the current list only; `as_of` is the date of the snapshot the results come from. This endpoint returns no rates: combine it with the GSA per diem lookups for the lodging ceiling.

Search FEMA-listed properties by name and town Return the properties whose name or city contains every word of `q`, case-insensitively, as a plain substring: `courtyard dallas` matches Courtyard properties in Dallas, `mint house alexandria` the Mint House in Alexandria. There is no fuzzy matching, so `hampton inn` does not find "Hampton by Hilton". Words of one character are ignored. `state` narrows the search to one state or territory (404 for a code FEMA does not list). Results are ordered by name then city and paginated with `offset` and `limit` (50 by default, 200 at most); `total` counts every match. No match returns an empty `results` list. The Hotel and Motel Fire Safety Act of 1990 requires federal travelers to stay at a property on FEMA's Hotel and Motel National Master List to be reimbursed for lodging. Each property on the list has a FEMA ID. FEMA publishes the current list only; `as_of` is the date of the snapshot the results come from. This endpoint returns no rates: combine it with the GSA per diem lookups for the lodging ceiling.

GS locality pay areas, optionally by county or city List the locality pay areas of the latest pay year, with the code to use on the pay endpoints. The optional `location` keeps the areas whose name contains every word, and the areas of the counties and cities with that name. `state` narrows `location` to one state and has no effect without it. County and city names must match exactly, ignoring case; a trailing `county` is optional. A place outside every listed area returns Rest of U.S. (`RUS`). Area names keep matching on any word they contain. `matched_places` lists the counties and cities behind each result. A place name can return several areas: the same name can exist in several states, which `state` narrows, and a city can span several areas, in which case all of them are returned and the official duty station decides. City data is not published by OPM, so for payroll use `/v1/opm/localities/county/{fips}`. An empty result does not mean Rest of U.S.: the name may be misspelled, and U.S. territories are not covered.

GS locality pay area of a county Return the locality pay area of a county for the latest pay year, using OPM's own definitions. A county that OPM doesn't list under an area falls under Rest of U.S. (`RUS`), and every county in Alaska or Hawaii returns that state's area. Returns 404 for an unknown code and for a Connecticut planning region, as OPM defines Connecticut by its eight legacy counties. U.S. territories fall under Rest of U.S. in OPM's definitions, but their county codes are not available here and return 404. Burlington County, NJ (`34005`) returns the Philadelphia area, while three military sites inside it (Fort Dix, Joint Base McGuire-Dix-Lakehurst and McGuire Air Force Base) belong to the New York area.

GS pay by locality code Return the latest pay table of a locality pay area, ordered by grade and step, or 404 for an unknown code. `grade` and `step` narrow the rates. Use `GS` for the base table without locality pay, and `RUS` for Rest of U.S.

Search GS pay by locality area Return the latest pay tables whose locality area matches every word of `q`: each word must be contained in the area name, case-insensitively, or equal its code. `grade` and `step` narrow the rates. No match returns an empty `results` list. Matching only looks at OPM's locality area names, not at the counties and towns each area covers: `naperville` finds Chicago because the name contains it, while a town missing from the names returns nothing. No match does not mean the place falls under Rest of U.S.

DSSR per diem by country

DSSR per diem by location name

DSSR per diem by location post code

Search DSSR Per Diem by country/location name Search globally by case-insensitive substring of a location or country name. The date selects effective and seasonal rates and defaults to today. The response effective_date is the first day of the selected month. Missing, blank, or fewer than three characters after trimming returns HTTP 422. A valid search with no matching rates returns HTTP 404.

DSSR allowances by country

DSSR allowances by location name

DSSR allowances by location post code

Calculate POV mileage reimbursement Calculate mileage reimbursement using the official GSA rate in effect on the travel date. Provide a distance in miles and select automobile, airplane, motorcycle, or moving mileage. For automobile travel, indicate whether a government-furnished automobile was authorized and available; this determines whether the standard or reduced rate applies. If no travel date is supplied, today's date is used. The response identifies the selected rate category, rate and effective date, and the reimbursement amount rounded to the nearest cent.

Calculate a GSA CONUS trip per diem entitlement <p>Calculate estimated lodging and meals and incidental expenses (M&amp;IE) reimbursement for a trip within the continental United States. The response provides a daily breakdown and trip totals.</p> <h3 class="text-xl">Describe the trip</h3> <ul class="list-disc"> <li>Add each temporary-duty stop in travel order, with inclusive arrival and departure dates.</li> <li>Identify each stop with a GSA destination ID or ZIP code. A stop represents the temporary-duty locality, which may differ from the hotel location.</li> <li>Optionally provide the actual nightly lodging cost and any meals that must be deducted.</li> <li>When one stop ends on the same date another begins, the arriving stop applies to that date.</li> </ul> <h3 class="text-xl">Calculation rules</h3> <ul class="list-disc"> <li>The calculator selects the GSA rate in effect for each day, including seasonal and fiscal-year changes.</li> <li>First and last travel days receive 75% of the M&amp;IE rate; intermediate days receive 100%.</li> <li>Submitted meal deductions use the official GSA meal values while preserving the required incidental expense amount.</li> <li>Lodging reimbursement is limited to the nightly GSA cap. Any amount above the cap is reported as <code>overage</code> and is not included in the payable total.</li> </ul> <h3 class="text-xl">Important notes</h3> <ul class="list-disc"> <li>Submit only meals that you have determined must be deducted under FTR 301-11.21.</li> <li>Single-day reimbursement applies only when the traveler is in eligible travel status for more than 12 hours.</li> <li>If a lodging cost is omitted, the response still shows the nightly cap, but lodging and overall payable totals are <code>null</code>.</li> <li>The response includes the calculation version and a source fingerprint to support auditing.</li> </ul>

City Pair airport and city codes List or search the three-letter codes used by GSA City Pair awards for the fiscal year of `date` (today by default), with GSA's own city, state and country labels. Awards use IATA airport codes (DCA, IAD, BWI) for most domestic pairs and metropolitan city codes (WAS, NYC, LON) for others; only GSA decides which, so resolve the code here before calling the fare lookup. Several codes can share one city label. Without `q`, every code of the fiscal year is returned, ordered by code. With `q` (3+ characters), a code matches exactly and city/country names match by substring, case-insensitively. Plan/date rules are those of the fare lookup: Sandbox and Google add-on today only; Pro the current US fiscal year; Business (including Enterprise accounts) any loaded fiscal year. Example: ```sh curl --get 'https://api.allowancesapi.com/v1/gsa/city-pairs/locations' -H 'X-API-Key: YOUR_KEY' --data-urlencode 'q=washington' ``` Labels mirror the latest imported awards table and change with it.

City Pair contract airfares Return every GSA contract award matching the airport/city code pair and date (today by default). Codes are returned in alphabetical order; fares are one-way USD and valid in either direction. Source start/end dates are inclusive; overlapping amendments are both returned. No fallback to other fiscal years or dates. Null fare categories are unavailable. Sandbox and Google add-on: today only. Pro: current US fiscal year. Business (including Enterprise accounts): any loaded fiscal year, including published future awards. Data reflects the latest imported table, not past publication snapshots. These are eligible government travelers' contract prices, not live seat availability or booking offers. Domestic fares exclude passenger facility, segment and security fees; international fares exclude taxes/fees but include fuel surcharges. Book through the agency's authorized system. [Official CPP rules and price caveats](https://www.gsa.gov/travel/plan-a-trip/transportation-airfare-rates-pov-rates/airfare-rates-city-pair-program); [fare definitions](https://www.gsa.gov/travel/plan-a-trip/transportation-airfare-rates-pov-rates/airfare-rates-city-pair-program/government-airfare-types). Example (fixed date; use Business access for dates outside the current fiscal year): ```sh curl --get 'https://api.allowancesapi.com/v1/gsa/city-pairs/ABE/ATL' -H 'X-API-Key: YOUR_KEY' -H 'X-Bypass-Cache: 1' --data-urlencode 'date=2026-10-28' --data-urlencode 'verification_url=true' ``` See the 200 response example for all result fields. Importing does not invalidate existing cached responses; use X-Bypass-Cache: 1 to verify newly imported data.

List DSSR locations Return DSSR locations, optionally filtered by q=<name>. The response is paginated and includes the total number of matching locations (ignoring pagination) along with the offset and limit that were applied.

List DSSR locations by country Return all DSSR locations for a specific country using its ISO alpha-2 code (e.g., 'AF', 'DE')

DSSR COLA calculator by postcode Returns the rate in percentage, the annual and the biweekly amounts of cost of living allowance (COLA) for a given DSSR postcode. Use this endpoint to automate your COLA calculations and replace the official excel file.

Resolve a country name to its ISO code and list its posts

Get country by ISO code

Get GSA destination metadata by ID Return the geographic metadata for one GSA destination rate area. A destination may represent a city, metropolitan area, county, group of jurisdictions, or the Standard CONUS area rather than a single municipality. `name` is GSA's short display name, while `defined_name` describes the geographic scope of the rate area. `destination_id` is GSA's numeric identifier for that rate area. Use [`GET /v1/gsa/destinations`](/docs#tag/GSA---CONUS-locations/operation/get_destinations_v1_gsa_destinations_get) to browse available destinations and find an ID. ID `0` identifies the Standard CONUS rate area. This endpoint returns destination metadata only. Use `GET /v1/gsa/perdiem/destination/{destination_id}` to retrieve the per diem rate in effect for a particular date.

List GSA destinations Return the paginated list of GSA destination rate areas and their numeric IDs. A destination is an area for which GSA publishes a per diem rate; it may represent a city, metropolitan area, county, locality, or the Standard CONUS area rather than a single municipality. Use `destination_id` with `GET /v1/gsa/perdiem/destination/{destination_id}` to retrieve the rate in effect for that destination. ID `0` identifies the Standard CONUS rate. `name` is GSA's display name, while `defined_name`, `county`, and state fields provide the geographic context needed to select the correct rate area. Results are ordered by `destination_id`. Use `offset` and `limit` to page through the list. An offset beyond the available records returns an empty list, not a 404 response.

GSA Fleet vehicle leasing rates by SIN Return the GSA Fleet vehicle leasing rates (monthly lease rate and rate per mile) for the vehicle type identified by its Standard Item Number (SIN), from the standard (US) or europe rate schedule. If year is not specified, the current fiscal year's rates will be returned. Rates are available from fiscal year 2022.

Latest data publications

M&IE meal breakdowns Return how daily M&IE totals break down into breakfast, lunch, dinner and incidental expenses, as in effect on the given date. The CONUS table breaks down the five standard CONUS M&IE tiers and is returned by default. Set region=oconus for the generic DTMO/DSSR M&IE total table. If date is not specified, today's breakdowns will be returned.

POV mileage reimbursement rates Return the privately owned vehicle (POV) mileage reimbursement rates in effect on the given date. If date is not specified, today's rates will be returned.

Get User

Get ZIP code metadata Look up every state associated with a US ZIP code. Most ZIP codes belong to one state, but some cross state boundaries. In that case, `states` contains every matching state; the API does not choose one on the caller's behalf. This is a geographic metadata endpoint; it does not return GSA per diem rates. Use `/v1/gsa/perdiem/zipcode/{zipcode}` for rates. The path accepts either a five-digit ZIP code or ZIP+4. ZIP+4 values are normalized to their first five digits before lookup, and the normalized five-digit ZIP is returned in the response. Leading zeroes are significant, so ZIP codes must be sent as strings.