API URL
GET /api/v1/unemployment
Headers
Code
Content-Type: application/jsonQuery Parameters
Param
Type
Description
period
optional
string
Period option constrained by endpoint
adjusted
optional
boolean
National rate seasonal adjustment selector
measure
optional
string
U-measure selector u1 through u6 or all
metric
optional
string
Labor-force metric selector participation employment-ratio or both
type
optional
string
Claims selector initial continued or both
group
optional
string
Demographic group age gender race or education
state
optional
string
Two-letter state or DC code
Example GET Request
Code
GET https://datpaq.com/api/v1/unemployment?api_key=your-api-key&period=latestSuccessful Response
Status
HTML
200 OKBody
Code
{
"success": true,
"name": "National Unemployment Rate (Seasonally Adjusted)",
"unit": "%",
"adjusted": true,
"period": "latest",
"latest": {
"date": "2026-06-01",
"value": 4.1
},
"changes": null,
"metadata": {
"correlationId": "request-id",
"api_token_name": null,
"processingTime": "8ms",
"timestamp": "2026-10-14T12:00:00.000Z",
"rate_limit": null,
"source": "FRED / BLS CPS",
"seriesId": "UNRATE",
"fromCache": false
}
}Field
Type
success
boolean
name
string
unit
string
adjusted
boolean
period
string
latest
object
data
array
changes
object
measures
array
participation
object
employmentRatio
object
initialClaims
object
continuedClaims
object
group
string
breakdown
array
state
string
count
number
states
array
endpoints
object
series
object
available
boolean
reason
string
feature
string
error
string
metadata
object
correlationId
string
timestamp
string
processingTime
string
source
string
metadata_source
string
metadata_seriesId
string
metadata_fromCache
boolean
metadata_note
string
Error Response
Example
Code
HTTP 400 ValidationError: Missing or invalid route parameter — Request rejected by query validation; HTTP 401 Unauthorized: Missing or invalid API key — Gateway authentication rejects the request; HTTP 404 NotFound: Unknown route — Request does not match a defined endpoint; HTTP 429 RateLimited: Request count exceeds 200 per 15-minute window per IP — Rate limiter rejects the request; HTTP 500 InternalError: Metrics generation or shared middleware failure — Metrics route or middleware returns an internal error; HTTP 503 Unavailable: Missing provider access provider failure or metro infrastructure gate — Route returns unsuccessful result or explicit feature-gated responseLast Updated: May 4, 2026