Releases

Trace an answer to its source dataset.

GET/api/v1/releases

List releases

GET /api/v1/releases lists accepted PFS and ZIP datasets, newest effective date first, then revision and ID descending. It exposes public provenance, never private import manifests or archive paths.

Optional attributes

Name
family
Type
string
Description
pfs or zip. Omit to return both families.
Name
date
Type
string
Description
YYYY-MM-DD. Only return releases whose effective interval contains this date.
Name
page
Type
integer
Description
Page number, starting at 1. Defaults to 1; maximum 10,000.
Name
limit
Type
integer
Description
Results per page. Defaults to 25; accepts 1–100.

Parameter usage notes

Optional family is pfs or zip. Optional date filters releases whose effective interval contains that service date. Omit it to browse release history. page defaults to 1; limit defaults to 25 and accepts 1–100.

Response

Name
data
Type
object[]
Description
Accepted releases, newest effective date and revision first.
Name
data[].id
Type
integer
Description
id of the dataset release.
Name
data[].revision
Type
integer
Description
revision of the dataset release.
Name
data[].family
Type
string
Description
family of the dataset release.
Name
data[].label
Type
string
Description
label of the dataset release.
Name
data[].sha256
Type
string
Description
sha256 of the dataset release.
Name
data[].parser_version
Type
string
Description
parser version of the dataset release.
Name
data[].effective_from
Type
string
Description
effective from of the dataset release.
Name
data[].effective_until
Type
string
Description
Exclusive end of the effective interval.
Name
data[].accepted
Type
boolean
Description
Always true for this collection.
Name
data[].source_url
Type
string | null
Description
Public source download URL.
Name
meta.page
Type
integer
Description
Current page number.
Name
meta.limit
Type
integer
Description
Maximum results per page.
Name
meta.total
Type
integer
Description
Total matching records.
Name
meta.next_page
Type
integer | null
Description
Next page number, or null when there are no more pages.

Response behavior and edge cases

Collections return data and meta with page, limit, total, and next_page.

Each release contains id, family, label, revision, effective_from, effective_until, sha256, parser_version, accepted, and nullable source_url. Effective intervals include effective_from and exclude effective_until. Multiple accepted revisions may cover one date; pricing selects the latest applicable revision.

Historical comparisons

Use effective dates from this collection to request historical rates, then compare the returned amounts. Store the rate's release and request include=sources when you need the exact source rows and hashes.

The service date selects data; it does not pin a revision. Explicit release selection is not supported. Unaccepted imports are never listed.

Request

GET

/api/v1/releases

curl -G 'https://feebase.co/api/v1/releases' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Response

{
  "data": [
    {
      "id": 1,
      "label": "Example PFS release",
      "revision": 1,
      "family": "pfs",
      "effective_from": "2026-01-01",
      "effective_until": "2027-01-01",
      "sha256": "0000000000000000000000000000000000000000000000000000000000000000",
      "parser_version": "1",
      "accepted": true,
      "source_url": null
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "total": 1,
    "next_page": null
  }
}

Illustrative response. Values and release IDs are examples.