Requirements for many areas at once

post

https://api.lightcast.io/io/us/{datarun}/{year}/batch_requirements

Returns pre-computed requirements rows for one sector across every area
in a single region. Areas with no pre-computed row are absent from the
response.

Constraints, all enforced with 400:

exactly one region (it may contain many areas);
area type must be county, state, or msa — zip is rejected;
limit_sectors must contain exactly one sector.

Unlike every other data endpoint, the JSON response is a flat array of
rows rather than the standard SAM result set.

POST-only: limit_sectors is mandatory here and can only be sent in a
request body — see Inputs.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

datarun

string

required

SAM datarun version, as listed by GET /io/us.

year

string

required

Data year, as listed by GET /io/us/{datarun}.

Query Params

areas

string

Comma-separated area IDs, as an alternative to supplying region in the
body. Builds a single unnamed region. Supplying this key more than once
is rejected with 400.

type

string

enum

Defaults to county

Area type for areas on this endpoint. Defaults to county; zip is
not accepted here.

Allowed:

Body Params

limit_sectors is required here and must contain exactly one
sector.

region

array of objects

required

length ≥ 1

One region for a single-region model, more than one to run
multi-regionally. Multi-regional runs require every region to be
named and are only supported by services that report HasMR(true)
from GET /io/us/{datarun}/{year}. The array must not be empty.

region*

closuretype

string

enum

Defaults to TypeEMSI

Closure method for the model.

TypeI / Type1 / 1 / I — direct and indirect effects
TypeII / Type2 / 2 / II — direct, indirect, and limited induced effects
TypeEMSI — Lightcast's custom closure, used by Analyst

Matching is case-insensitive.

Allowed:

limit_sectors

array of strings

required

Restrict the output rows to these sectors. Codes may be given fully
qualified (z|111000) or bare (111000), in which case the
industry prefix is inferred.

limit_sectors*

logging

boolean

Accepted for backwards compatibility. Has no effect on the response.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/csv

text/plain

200Requirements rows, one per area that has data for the requested sector.

401Kong rejected a missing, invalid, or expired OAuth token.

403Kong rejected a token lacking a required scope. Some application operational conditions also return 403 with a text/plain body.

500The request could not be completed. The body carries a diagnostic message and is served as text/plain. This is also the response to a multi-regional request to a service that does not support multi-regional models.