Run one or more basic metrics

post

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

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}.

service

string

enum

required

The data service to run. basics bundles several services in one
request via the metrics array; every other value runs that single
service. Matching is case-insensitive.

Note that scenario, bulk, requirements, spending, econbase,
and batch_requirements are documented as their own paths below
because they take additional inputs.

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. Defaults to county.

Allowed:

closuretype

string

enum

Defaults to TypeEMSI

Closure method, as an alternative to supplying it in the body.

Allowed:

Body Params

Inputs common to every data-producing endpoint. Validation is strict:
any property not listed here (or added by the endpoint's own schema) is
rejected with 400. Query-string parameters are validated as part of
this same object, so an unrecognised query parameter fails the same way.

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

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.

metrics

array of objects

Required when the path segment is basics, ignored otherwise.
Must be non-empty and every entry must carry a unique, non-empty
altName.

metrics

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

200Model results.

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.