Civil Service List Certification — NYC Open Data

A List Certification includes the names of eligible candidates on an Active Civil Service List that has been established. The Certification may contain part of a list, the whole list, or multiple lists at the request of an appointing agency, to fill vacancies and/or replace provisionals. Eligible candidates on a Certification may be considered for probable appointment at the appointing Agency. This Actor returns it as one flat JSON row per record, with 21 declared fields — typed, named and documented in the dataset schema, so a spreadsheet or an agent can use it without guessing.

What you get

Field	Type	Meaning
mi	string	MI
no_vacancies	number	No Vacancies
sel_cert_description	string	Sel Cert Description
list_title_desc	string	List Title Desc
request_date	string	Request Date
reissue_date	string	Reissue Date
cert_expiration_date	string	Cert Expiration Date
cert_date	string	Cert Date
cert_issue_no	number	Cert Issue No
salary	number	Salary
first_name	string	First Name
no_requested	number	No Requested
list_no	number	List No
list_agency_desc	string	List Agency Desc
last_name	string	Last Name
list_title_code	number	List Title Code
list_agency_code	number	List Agency Code
no_certified	number	No Certified
exam_no	number	Exam No
cert_seq_no	number	Cert Seq No

The output schema lists all 21 fields; the table above is the first twenty.

Every row also carries sourceRowId, sourceUpdatedAt and scrapedAt, so a pipeline can tell one record from another and know exactly when it was read.

{
  "mi": "C",
  "no_vacancies": 6,
  "sel_cert_description": "text",
  "list_title_desc": "SUPERVISOR OF MECHANICAL INSTALLATIONS AND MAINTENANCE",
  "request_date": "2026-10-21T00:00:00.000",
  "reissue_date": "text",
  "cert_expiration_date": "2026-11-27T00:00:00.000",
  "cert_date": "2026-10-23T00:00:00.000"
}

Inputs

Field	What it does
Filter (SoQL)	Applied at the source, so a narrow question fetches a narrow page instead of downloading everything.
Order	Empty keeps the publisher's own order; set a column to sort, for example amount DESC.
Maximum rows	Hard cap. The source is paged 1,000 rows at a time.
Time budget	Stops cleanly and reports how far it got.
Pause between pages	Keeps the run inside the publisher's rate limits.

Limitations

• This is one dataset, from one publisher. It is the Civil Service List Certification dataset as Department of Citywide Administrative Services (DCAS) publishes it — not a national or cross-city equivalent, and not a merge with other sources.
• The publisher can change it. Columns are added, renamed and retired upstream; the field list here is the schema the Actor was generated from. A renamed column arrives as a new field only after the Actor is updated.
• Fields are typed from live records. A column that was empty in the sample is declared as text; a value that does not fit the declared type comes back null rather than being coerced into a wrong number.
• Records are what the publisher publishes. No geocoding, no de-duplication across datasets, no enrichment.
• Freshness is the publisher's. The data was last changed upstream on 2026-10-23. Where the publisher supplies a row timestamp it appears as sourceUpdatedAt; scrapedAt records when this Actor read the row.

Why this is different

• Civil Service List Certification — NYC Open Data declares all 21 of its output fields in the dataset schema, each with a type, a description and an example.
• The Actor reads the Civil Service List Certification dataset directly from NYC Open Data; no key, login or account is needed.
• Filters run at the source with SoQL, so a narrow request returns a narrow page rather than a full download.
• Every row is flat JSON: nested location objects become latitude and longitude, and no field holds a nested object.
• The row id is stable, so the same request de-duplicates instead of returning the same record twice.

FAQ

Do I need an API key? No. NYC Open Data publishes this dataset openly.

How fresh is it? The Actor reads the dataset live. scrapedAt records when each row was read, and sourceUpdatedAt carries the publisher's own row timestamp where it supplies one.

Can I filter by date or status? Yes — use the Filter field with SoQL, for example status = 'Active'.

What happens if my filter is wrong? The run stops with the portal's own message and the hint to check SoQL, rather than returning an empty dataset that looks like "no data".

Is this the whole dataset? Up to your row cap, paged 1,000 at a time. Raise the cap to read more.

What is sourceRowId? The publisher's own row id when it supplies one, otherwise a stable hash of the row. Either way it is what makes de-duplication and joins possible.

Pricing

Pay per result: $0.0005 per row. Each stored dataset row is billed, including any diagnostic row returned instead of results.

An Actor-start event is also charged at $0.0001 per GB of allocated memory (minimum one event), even if no rows are returned. At 1 GB or less, 1,000 result rows cost $0.5001 before any applicable Store discount.

Data source

NYC Open Data — Civil Service List Certification, published by Department of Citywide Administrative Services (DCAS). Public data under the portal's open-data terms.