{
"query": {
"city": "Boston",
"state": "MA",
"date": "2026-11-05"
},
"fiscalYear": 2027,
"date": "2026-11-05",
"month": "2026-11",
"location": {
"destinationId": 148,
"name": "Boston / Cambridge",
"state": "MA",
"definedAs": "Suffolk, city of Cambridge",
"standardRate": false,
"fiscalYear": 2027,
"counties": [
"Suffolk County"
],
"cities": [
"Cambridge"
]
},
"matchedBy": "destination-name",
"lodging": 213,
"mie": 92,
"maxPerDiem": 305,
"months": [
{
"month": "2026-10",
"lodging": 365
},
{
"month": "2026-11",
"lodging": 213
},
{
"month": "2026-12",
"lodging": 213
},
{
"month": "2027-01",
"lodging": 213
},
{
"month": "2027-02",
"lodging": 213
},
{
"month": "2027-03",
"lodging": 305
},
{
"month": "2027-04",
"lodging": 305
},
{
"month": "2027-05",
"lodging": 305
},
{
"month": "2027-06",
"lodging": 305
},
{
"month": "2027-07",
"lodging": 305
},
{
"month": "2027-08",
"lodging": 305
},
{
"month": "2027-09",
"lodging": 365
}
],
"seasons": [
{
"from": "2026-10",
"to": "2026-10",
"lodging": 365
},
{
"from": "2026-11",
"to": "2027-02",
"lodging": 213
},
{
"from": "2027-03",
"to": "2027-08",
"lodging": 305
},
{
"from": "2027-09",
"to": "2027-09",
"lodging": 365
}
],
"mieBreakdown": {
"breakfast": 23,
"lunch": 26,
"dinner": 38,
"incidentals": 5,
"firstLastDay": 69
},
"alternatives": [],
"notes": []
}
curl --location --request GET 'https://zylalabs.com/api/14559/federal+per+diem+rates+api/37296/per+diem+rates+for+a+place+and+date?city=Boston&state=MA&date=2026-11-05' --header 'Authorization: Bearer YOUR_API_KEY'
{
"start": "2026-09-29",
"end": "2026-10-02",
"days": 4,
"nights": 3,
"fiscalYears": [
2026,
2027
],
"legs": [
{
"arrive": "2026-09-29",
"depart": "2026-10-02",
"nights": 3,
"location": {
"destinationId": 2,
"name": "Gulf Shores",
"state": "AL",
"definedAs": "Baldwin",
"standardRate": false,
"fiscalYear": 2026,
"matchedBy": "destination-name"
}
}
],
"lines": [
{
"date": "2026-09-29",
"fiscalYear": 2026,
"lodging": {
"location": {
"destinationId": 2,
"name": "Gulf Shores",
"state": "AL",
"definedAs": "Baldwin",
"standardRate": false,
"fiscalYear": 2026
},
"rate": 134
},
"mie": {
"location": {
"destinationId": 2,
"name": "Gulf Shores",
"state": "AL",
"definedAs": "Baldwin",
"standardRate": false,
"fiscalYear": 2026
},
"rate": 74,
"percent": 75,
"base": 55.5,
"amount": 55.5
},
"total": 189.5
},
{
"date": "2026-09-30",
"fiscalYear": 2026,
"lodging": {
"location": {
"destinationId": 2,
"name": "Gulf Shores",
"state": "AL",
"definedAs": "Baldwin",
"standardRate": false,
"fiscalYear": 2026
},
"rate": 134
},
"mie": {
"location": {
"destinationId": 2,
"name": "Gulf Shores",
"state": "AL",
"definedAs": "Baldwin",
"standardRate": false,
"fiscalYear": 2026
},
"rate": 74,
"percent": 100,
"base": 74,
"amount": 74
},
"total": 208
},
{
"date": "2026-10-01",
"fiscalYear": 2027,
"lodging": {
"location": {
"destinationId": 2,
"name": "Gulf Shores",
"state": "AL",
"definedAs": "Baldwin",
"standardRate": false,
"fiscalYear": 2027
},
"rate": 144
},
"mie": {
"location": {
"destinationId": 2,
"name": "Gulf Shores",
"state": "AL",
"definedAs": "Baldwin",
"standardRate": false,
"fiscalYear": 2027
},
"rate": 74,
"percent": 100,
"base": 74,
"amount": 74
},
"total": 218
},
{
"date": "2026-10-02",
"fiscalYear": 2027,
"lodging": null,
"mie": {
"location": {
"destinationId": 2,
"name": "Gulf Shores",
"state": "AL",
"definedAs": "Baldwin",
"standardRate": false,
"fiscalYear": 2027
},
"rate": 74,
"percent": 75,
"base": 55.5,
"amount": 55.5
},
"total": 55.5
}
],
"totals": {
"lodging": 412,
"mie": 259,
"mealDeductions": 0,
"total": 671
},
"rules": [
"Lodging: maximum rate per night for the place, month and fiscal year of that night; no lodging on the last day; taxes not included (41 CFR 301-11.16).",
"M&IE: 75% on the first and last day of travel, 100% on full days (41 CFR 301-11.101).",
"M&IE rate: the place where you lodge that night; the last day uses the previous night's place (41 CFR 301-11.102).",
"Provided meals: the M&IE breakdown amount is deducted, the full amount even on the 75% days, never below the incidental-expenses amount (41 CFR 301-11.21)."
],
"warnings": []
}
curl --location --request GET 'https://zylalabs.com/api/14559/federal+per+diem+rates+api/37297/trip+totals+for+one+place?city=Gulf Shores&state=AL&start=2026-09-29&end=2026-10-02' --header 'Authorization: Bearer YOUR_API_KEY'
{
"fiscalYears": [
2026
],
"tiers": [
{
"total": 68,
"breakfast": 16,
"lunch": 19,
"dinner": 28,
"incidentals": 5,
"firstLastDay": 51
},
{
"total": 74,
"breakfast": 18,
"lunch": 20,
"dinner": 31,
"incidentals": 5,
"firstLastDay": 55.5
},
{
"total": 80,
"breakfast": 20,
"lunch": 22,
"dinner": 33,
"incidentals": 5,
"firstLastDay": 60
},
{
"total": 86,
"breakfast": 22,
"lunch": 23,
"dinner": 36,
"incidentals": 5,
"firstLastDay": 64.5
},
{
"total": 92,
"breakfast": 23,
"lunch": 26,
"dinner": 38,
"incidentals": 5,
"firstLastDay": 69
}
],
"standardMie": {
"FY2026": 68
},
"notes": [
"Use the breakdown to deduct meals provided by the government or included in a registration fee (41 CFR 301-11.21). Meals on a common carrier and a hotel's complimentary breakfast are not deducted.",
"firstLastDay is 75% of the total, for the day of departure and the last day of travel (41 CFR 301-11.101). A provided meal on those days is deducted at its full amount from the 75% figure.",
"Deductions never take a day below the incidentals amount.",
"These tiers are the official \"FY 25-Present\" breakdown, which covers both loaded fiscal years."
]
}
curl --location --request GET 'https://zylalabs.com/api/14559/federal+per+diem+rates+api/37298/m+ie+breakdown+by+tier?fy=2026' --header 'Authorization: Bearer YOUR_API_KEY'
{
"fiscalYear": 2027,
"standard": {
"lodging": 113,
"mie": 68,
"appliesTo": "every CONUS county and city not covered by a non-standard area"
},
"total": 13,
"count": 2,
"offset": 0,
"locations": [
{
"destinationId": 147,
"name": "Andover",
"state": "MA",
"definedAs": "Essex",
"standardRate": false,
"fiscalYear": 2027,
"counties": [
"Essex County"
],
"cities": [],
"mie": 80,
"lodging": {
"min": 137,
"max": 137,
"seasonal": false
},
"seasons": [
{
"from": "2026-10",
"to": "2027-09",
"lodging": 137
}
]
},
{
"destinationId": 148,
"name": "Boston / Cambridge",
"state": "MA",
"definedAs": "Suffolk, city of Cambridge",
"standardRate": false,
"fiscalYear": 2027,
"counties": [
"Suffolk County"
],
"cities": [
"Cambridge"
],
"mie": 92,
"lodging": {
"min": 213,
"max": 365,
"seasonal": true
},
"seasons": [
{
"from": "2026-10",
"to": "2026-10",
"lodging": 365
},
{
"from": "2026-11",
"to": "2027-02",
"lodging": 213
},
{
"from": "2027-03",
"to": "2027-08",
"lodging": 305
},
{
"from": "2027-09",
"to": "2027-09",
"lodging": 365
}
]
}
]
}
curl --location --request GET 'https://zylalabs.com/api/14559/federal+per+diem+rates+api/37299/non-standard+areas+by+state+or+search?state=MA&fy=2027&limit=2&offset=Optional' --header 'Authorization: Bearer YOUR_API_KEY'
{
"fiscalYears": [
{
"fiscalYear": 2026,
"begin": "2025-10-01",
"end": "2026-09-30",
"standard": {
"lodging": 110,
"mie": 68
},
"nonStandardAreas": 296,
"mieTiers": [
68,
74,
80,
86,
92
],
"files": [
"FY2026_PerDiemMasterRatesFile.xlsx",
"FY2026_ZipCodeFile.xlsx"
]
},
{
"fiscalYear": 2027,
"begin": "2026-10-01",
"end": "2027-09-30",
"standard": {
"lodging": 113,
"mie": 68
},
"nonStandardAreas": 295,
"mieTiers": [
68,
74,
80,
86,
92
],
"files": [
"FY2027_PerDiemRates_Validated090126.xlsx",
"FY2027PerDiemZipCode_Validated090126.xlsx"
]
}
],
"coverage": {
"states": 48,
"plusDC": true,
"zipCodes": 40426,
"scope": "CONUS only (48 contiguous states and DC)."
},
"rules": [
"41 CFR 301-11.101: 75% of the M&IE rate on the day of departure and the last day of travel; 100% on full days; 75% for each day of a trip of more than 12 but less than 24 hours.",
"41 CFR 301-11.102: the M&IE rate of the place you lodge; on the day you return, the rate of the previous day.",
"41 CFR 301-11.21: deduct provided meals at the M&IE breakdown amounts, never below the incidentals amount."
]
}
curl --location --request GET 'https://zylalabs.com/api/14559/federal+per+diem+rates+api/37300/loaded+fiscal+years+sources+and+rules' --header 'Authorization: Bearer YOUR_API_KEY'
{
"state": "TX",
"name": "Texas",
"stateSalesTax": true,
"individuallyBilled": {
"exempt": true,
"status": "exempt",
"tax": "state sales tax",
"text": "Individually billed accounts (IBA) are exempt from state sales tax."
},
"centrallyBilled": {
"exempt": true,
"status": "exempt",
"tax": "state sales tax",
"text": "Centrally billed accounts (CBA) are exempt from state sales tax."
},
"traveler": {
"exempt": true,
"status": "exempt",
"lodgingForms": [
{
"name": "Form 12-302, Texas Hotel Occupancy Tax Exemption Certification",
"url": "https://comptroller.texas.gov/taxes/hotel/forms/"
}
],
"travelCardForms": [
{
"name": "Form 12-302, Texas Hotel Occupancy Tax Exemption Certification",
"url": "https://comptroller.texas.gov/taxes/hotel/forms/"
},
{
"name": "Form 14-305, Motor Vehicle Verification Certificate for Rental Tax",
"url": "https://comptroller.texas.gov/taxes/motor-vehicle/forms/"
}
]
},
"forms": {
"travel": [
{
"name": "Form 12-302, Texas Hotel Occupancy Tax Exemption Certification",
"url": "https://comptroller.texas.gov/taxes/hotel/forms/"
},
{
"name": "Form 14-305, Motor Vehicle Verification Certificate for Rental Tax",
"url": "https://comptroller.texas.gov/taxes/motor-vehicle/forms/"
}
]
},
"laws": [
{
"name": "Guidelines to Texas Tax Exemptions",
"url": "https://comptroller.texas.gov/taxes/publications/96-1045.php",
"note": "Select AP-204 Federal and all Others"
},
{
"name": "Texas Administrative Code, Rule 3.322 Exempt Organizations",
"url": "https://texas-sos.appianportalsgov.com/rules-and-meetings?interface=LANDING_PAGE",
"note": "Sections (C) and (G)"
}
],
"contact": {
"agencies": [
{
"name": "Texas Comptroller of Public Accounts",
"url": "https://comptroller.texas.gov/"
}
],
"other": [
"800-252-5555"
]
},
"notes": [],
"updated": "2026-07-01",
"explanations": [
"Federal travelers usually pay with an individually billed travel card (IBA): \"traveler\" summarizes the IBA status and the travel card forms. Centrally billed accounts (CBA) are billed to the agency.",
"Each statement names the tax it covers (state sales tax, hotel occupancy tax, transient lodging tax...). Local and city lodging taxes may still apply where the state exempts its own tax; see notes.",
"Hotels can ask for the form and government ID at check-in. Rules change: check the state's page (sourceUrl) or the contact before you rely on an exemption."
]
}
curl --location --request GET 'https://zylalabs.com/api/14559/federal+per+diem+rates+api/37419/hotel+and+sales+tax+exemption+by+state+for+government+cards?state=TX&card=travel' --header 'Authorization: Bearer YOUR_API_KEY'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Taxas Federais Diárias API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento.
Taxas de diária federal CONUS por cidade, condado ou CEP, além dos totais da viagem com a regra de 75%
Cada ponto de extremidade retorna dados específicos relacionados às taxas federais de diárias, incluindo taxas de hospedagem, detalhamentos de M&IE, totais de viagem e informações de áreas não padrão. Por exemplo, o ponto de extremidade de totais de viagem fornece custos de hospedagem para cada noite e cálculos de M&IE com base nas datas de viagem
Os campos principais incluem "localização" (nome e estado), "acomodação" (tarifa), "mie" (Despesas de Refeições e Incidentes), "anoFiscal" e "meses" (para tarifas de acomodação). Cada ponto final possui campos exclusivos relevantes para seus dados específicos, como "pernas" nos totais de viagem
Os parâmetros variam de acordo com o ponto de extremidade. Para o ponto de extremidade das taxas diárias, você pode especificar "cidade", "estado", "condado", "CEP" e "data". O ponto de extremidade dos totais da viagem requer datas de "início" e "fim", enquanto o ponto de extremidade da quebra de M&IE foca em anos fiscais
Os dados da resposta estão estruturados no formato JSON, organizados em objetos aninhados. Por exemplo, a resposta dos totais da viagem inclui matrizes para "pernas" e "linhas", detalhando cada parte da viagem e os custos associados, facilitando a análise e utilização
Os dados são extraídos da Administração de Serviços Gerais (GSA) e dos arquivos do Escritório do Censo. A API inclui hashes SHA-256 para integridade dos dados, garantindo que os usuários possam verificar a autenticidade dos dados fornecidos
Casos de uso típicos incluem calcular despesas de viagem para funcionários federais orçamentar viagens e analisar taxas diárias em diferentes locais Os usuários também podem comparar tarifas de hospedagem e M&IE em vários anos fiscais
Os usuários podem utilizar os dados retornados extraindo campos-chave para relatórios ou análises Por exemplo eles podem calcular o custo total de viagem somando os valores de hospedagem e M&IE do endpoint de totais de viagem ou avaliar as variações nas tarifas por mês
Se a API retornar resultados parciais ou vazios os usuários devem verificar os parâmetros quanto à precisão Para locais ambíguos a resposta indicará "alternativas" para ajudar os usuários a refinarem suas consultas Sempre garantir que a data e o local especificados sejam válidos