Curaçao data
API reference.

Get a neighborhood’s geography, census figures and linked waste schedules in one response. The API also provides public holidays, school dates, fuel and utility tariffs, price indices, visitor arrivals, statutory rates, official exchange rates, and government address points.

Base URL: https://api.korsou.dev/v1. No API key. Public GET, HEAD and OPTIONS requests. Approximately 60 requests per minute per IP.

Neighborhoods

Search for a neighborhood, then pass its ID to the context endpoint.

curl 'https://api.korsou.dev/v1/neighborhoods?q=abrahamsz'
curl 'https://api.korsou.dev/v1/neighborhoods/nbh_abrahamsz/context'

The response includes the neighborhood, its geozone, census figures and matching waste-service places. Each section includes its source, date and availability.

Section	What you receive
`neighborhood`	Name, permanent ID, aliases and available population figures.
`geozone`	The larger CBS area this neighborhood belongs to.
`census`	Up to 100 neighborhood indicators. Continue with `next_cursor` on the census endpoint, using the same `neighborhood_id` and `limit=100`.
`waste`	Matching places and up to three ongoing or future set-out windows per zone, ordered by date. `has_more` indicates additional dates.

Optional as_of selects waste windows from a date and defaults to today in Curaçao. It does not change the census year. Set-out windows tell residents when to put waste outside; they are not exact pickup dates.

place_match means a provider’s place name is linked to the neighborhood. It does not confirm service for every address. neighborhood_coverage means the whole neighborhood is covered. A missing match does not rule out service.

When an optional section is unavailable, the response includes its status and empty data. Matching places can still appear when waste dates are unavailable. An unknown neighborhood returns 404; unavailable neighborhood data returns 503.

Individual geography, census and waste requests

Neighborhoods

Each neighborhood has a permanent nbh_ ID, alternate names and a geozone. Population figures are included where available. Search with q or filter by geozone_id. The geography and population figures come from CBS Census 2023; the available figures do not form a complete national population total.

Geozones

CBS geographic areas use permanent gz_ IDs. Polygon geometry is not available.

Census indicators

Census 2023 theme-table indicators for the gz_ geozones and nbh_ neighborhoods in the geography API. Each indicator names the place it describes. Cite CBS when using these figures. The available figures do not form a complete national population total.

Waste collection

Find waste collection schedules by place, neighborhood or zone. Query /v1/waste_zones or /v1/waste_collections by neighborhood_id and service. Zones include named places with stable IDs and optional links to CBS neighborhoods. A link does not confirm service across the whole neighborhood. Both endpoints accept place_id, including places without a CBS link. Collection queries also accept zone_id and inclusive from/to set-out dates.

Set-out windows tell residents when to put waste outside; they are not exact pickup dates. The optional collection window is omitted when unknown. Neighborhood coverage may be incomplete; unsupported neighborhood queries return 503 dataset_unavailable. Address-based lookup is not available. An empty collection list means no published dates match the query. Collection may still take place. See dataset metadata for availability and source reuse terms.

Calendars

Request public holidays and school vacation ranges separately. Holiday responses include local names and observed dates; school responses include inclusive start and end dates.

curl 'https://api.korsou.dev/v1/holidays/2026'
curl 'https://api.korsou.dev/v1/school_vacations?school_year=2026-2027'

Public holidays

Calendars are available for 2025 and 2026. Dates follow America/Curacao. A holiday ID stays the same each year. ID + date identifies one occurrence. The next-holiday endpoint includes today and uses the observed date when one is available. New Year’s Eve is partial; the government source does not specify hours. School and employment arrangements can differ from these dates.

School vacations

School vacation dates from government rosters for school years 2024–2025 through 2028–2029. Start and end dates are inclusive. Filter with school_year. School vacations are separate from the public holidays in /v1/holidays.

Tariffs

Fuel, electricity and water observations from government advertisements and decrees. Amounts keep the printed currency; the API does not convert NAF, NAf, CMg or Cg.

curl 'https://api.korsou.dev/v1/tariffs?product=mogas_95&limit=3'

Consumer price index

Overall CPI covers January 2024 through August 2026. Use category_code=total for this series. Detail for 47 CBS expenditure categories, including TOTAL, covers January 2025 through August 2026. All index levels use average 2023 = 100.

The 2024 rows omit monthly_change_percent and weight_2016 because the source table does not report them. Monthly change compares consecutive months. The inflation rate based on 12-month averages is not included.

Filter by period (YYYY-MM) or category_code. Category codes are slugs of CBS labels, not UN COICOP codes. Cite CBS when using these figures.

curl 'https://api.korsou.dev/v1/cpi?category_code=total&limit=100'

Visitor arrivals

Monthly stayover, cruise and day-tripper totals. Filter with period or metric. A market field appears only when the source names one. Cite the source when using these figures. Check dataset metadata for availability and reuse terms.

curl 'https://api.korsou.dev/v1/tourism_arrivals?period=2026-09'
curl 'https://api.korsou.dev/v1/tourism_arrivals?market=united_states'

Statutory rates

Minimum wage, poverty line and contribution-ceiling observations. Each record identifies its applicability: employee age range and gross or net pay, household composition, or insurance scheme. Filter households with adults and children, or ceilings with kind=contribution_ceiling. Amounts keep the printed currency. These records are not a government document or a payroll calculation.

curl 'https://api.korsou.dev/v1/statutory_rates?kind=poverty_line'
curl 'https://api.korsou.dev/v1/statutory_rates?kind=contribution_ceiling'

Official exchange rates

Working-day rates from the Centrale Bank van Curaçao en Sint Maarten for use by commercial banks. Each row is one published currency on one rate date, with buy notes, buy cheques/transfers and sell as printed. A second selling rate appears as sell_cheques when the bank prints one. Filter with currency, from or to. Weekends and bank holidays are omitted when the bank did not publish a row. These records are not a bank quote or a conversion service. Check dataset metadata for availability and reuse terms.

curl 'https://api.korsou.dev/v1/official_exchange_rates?currency=us_dollar'

Addresses & street names

Government of Curaçao / VVRP Basiskaart address points retrieved on 19 October 2026. The dataset includes 50,068 address points and 2,595 distinct names. The source update date is unknown. Coverage is incomplete and postal deliverability is not verified.

Curaçao has no national postcodes. /v1/addressing/profile returns country_code CW and has_postal_codes false. Use /v1/localities for neighborhood IDs and /v1/addressing/suggest to autocomplete localities, streets and addresses. Search with q; filter addresses with street_id and an exact house_number. Responses include formatted_address, coordinates and permanent adr_/str_ IDs. Source names retain their spelling and capitalization. Street records group address names, which may include area names; they are not physical road segments. Address points have no neighborhood relationships. Do not infer them from similar names or invent postcodes.

Source license: Unknown.

Endpoint reference

Use limit to request up to 100 records per page from a collection. Pass the returned cursor unchanged to get the next page. Cursors belong to a specific query and dataset version. Start again when a dataset update invalidates your cursor. Errors include a stable code and request ID. ETags exclude request-specific metadata; pass If-None-Match for conditional reads.

Discover the API

GET/v1

curl 'https://api.korsou.dev/v1'

Parameter	In	Required
`limit`	query	Optional
`cursor`	query	Optional
`q`	query	Optional
`geozone_id`	query	Optional

Curaçao dataAPI reference.

Neighborhoods

Neighborhoods

Geozones

Census indicators

Waste collection

Calendars

Public holidays

School vacations

Tariffs

Consumer price index

Visitor arrivals

Statutory rates

Official exchange rates

Addresses & street names

Endpoint reference

Discover the API

API health status

Dataset availability and provenance

Public holidays by year

Next public holiday

Public holidays for a year

Search geozones

Look up a permanent geozone ID

Search neighborhoods

Look up a permanent neighborhood ID

Neighborhood geography, census and upcoming waste schedules

Search government address points

Look up a permanent address ID

Search names used by address points

Look up a permanent street-name ID

Curaçao addressing profile

Resolve neighborhoods as localities

Suggest localities, streets and addresses

Company search (not yet available)

Company lookup by registry number (not yet available)

School vacation dates

Fuel, electricity and water tariffs

Census 2023 indicators by neighborhood or geozone

Monthly visitor arrivals

Minimum wage, poverty line and contribution ceilings

Official exchange rates for commercial banks

Monthly CPI by CBS expenditure category

Waste collection zones

Waste set-out dates by zone or neighborhood

Response schemas

Businesses (not yet available)

Sources & licensing

Curaçao data
API reference.