# Alberta Purchasing Connection Tenders API

> Alberta Purchasing Connection: Alberta public-sector tenders, awards and bidders, with UNSPSC codes

- Vendor: `albertapurchasingconnectionten` · version 1.0 · category Government Data · tags alberta tenders api, canada procurement api, government tenders api, public procurement api, rfp search api, unspsc codes api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/albertapurchasingconnectionten
- This document: https://apiclay.com/docs/albertapurchasingconnectionten.md
- OpenAPI 3.1: https://apiclay.com/api/albertapurchasingconnectionten/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `albertapurchasingconnectionten`
- Updated: 2026-11-18

## About

## Alberta Purchasing Connection Tenders API

The tender board of the Government of Alberta and the province's public bodies (municipalities, school boards, health and utilities such as the AESO): search about 21,000 opportunities by keyword, status, category and region with facet counts, each with reference number, title, buyer, description, solicitation and posting type, UNSPSC commodity codes, region and post and close dates; the full record of one opportunity with documents list, amendments, contact, interested suppliers, bidders and awards; the code lists behind the filters; the buying organisations; and UNSPSC code lookup.

Data comes from **purchasing.alberta.ca** (https://purchasing.alberta.ca). Every route calls the source's own public API and returns it unchanged.

Typical flow: POST `/search` with the sample body (change `query`, `statuses`, `limit`, `offset`), then `/opportunity?year=2026&amp;number=7545` for `AB-2026-07545`.

### Routes

#### POST `/search` - Search opportunities
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| query | body | string | no | Keywords, e.g. `bridge`; empty for all. |
| limit | body | number | yes | Results per page, up to about 25 (25 is about 130 KB). |
| offset | body | number | yes | Results to skip. |
| filter | body | object | yes | Keep every key of the sample. `statuses`, `categories`, `solicitationTypes`, `opportunityTypes`, `deliveryRegions` take objects like `{"value": "OPEN", "selected": true}`; status values `OPEN`, `CLOSED`, `EVALUATION`, `AWARD`, `CANCELLED`; categories `SRV`, `GD`, `CNST`. |
| sortOptions | body | array | yes | e.g. `[{"field": "PostDateTime", "direction": "Desc"}]`; `CloseDateTime` also works. |

Returns: `totalCount`, `facets` (counts by category, status, solicitation type, posting type, agreement and region) and `values`: `referenceNumber`, `shortTitle`, `title`, `contractingOrganization`, `projectDescription`, `categoryCode`, `statusCode`, `solicitationTypeCode`, `opportunityTypeCode`, `commodityCodes` and `commodityCodeTitles`, `regionOfDelivery`, `postDateTime`, `closeDateTime`.

#### GET `/opportunity` - Opportunity
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| year | path | number | yes | Year part of the reference, e.g. `2026`. |
| number | path | number | yes | Number part without zeros, e.g. `7545` for `AB-2026-07545`. |

Returns: `opportunity` (dates, values, trade agreement, submission method, documents, addenda, history), `contractingEntityContactInformation`, `interestedSuppliers`, `bidders`, `awards`, `lastAmendmentDate`, `cancelDate`, `commodityCodes`.

#### GET `/lookups` - Lookups
No parameters.

Returns: Code lists keyed by name: `opportunity-status`, `opportunity-category`, `opportunity-solicitation-type`, `opportunity-posting-type`, `region-of-delivery`, `trade-agreement`, `supplier-business-type` and more, each with `code`, `displayValue`, `description`. About 170 KB.

#### GET `/organizations` - Organizations
No parameters.

Returns: Array of about 530 buying organisations: `id`, `name`, `typeCode`, `parentId`, `children`, `isActive`. About 90 KB.

#### GET `/unspsc` - UNSPSC codes
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| prefix | query | string | yes | Leading digits of a UNSPSC code, e.g. `43211` (computers); two digits return a whole segment. |

Returns: Array: `code`, `codeTitle`, `codeLevel` (Class or Commodity), `gsinCode`.

### Caveats

- Records show the buyer's procurement contact and the names of bidding and awarded companies, as published on the public posting. Documents themselves need a free supplier account.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by purchasing.alberta.ca.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /search — Search opportunities
- Gateway: `POST https://api.apiclay.com/v1/api/albertapurchasingconnectionten/search`
- Body sample (JSON):

```json
{"query": "", "limit": 5, "offset": 0, "filter": {"solicitationNumber": "", "categories": [], "statuses": [{"value": "OPEN", "selected": true}], "agreementTypes": [], "solicitationTypes": [], "opportunityTypes": [], "deliveryRegions": [], "deliveryRegion": "", "organizations": [], "unspsc": [], "postDateRange": "$$custom", "closeDateRange": "$$custom", "onlyBookmarked": false, "onlyInterestExpressed": false}, "sortOptions": [{"field": "PostDateTime", "direction": "Desc"}]}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /opportunity — Opportunity
- Gateway: `GET https://api.apiclay.com/v1/api/albertapurchasingconnectionten/opportunity`
- Public query params: `year` (string, required), `number` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /lookups — Lookups
- Gateway: `GET https://api.apiclay.com/v1/api/albertapurchasingconnectionten/lookups`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /organizations — Organizations
- Gateway: `GET https://api.apiclay.com/v1/api/albertapurchasingconnectionten/organizations`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /unspsc — UNSPSC codes
- Gateway: `GET https://api.apiclay.com/v1/api/albertapurchasingconnectionten/unspsc`
- Public query params: `prefix` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/albertapurchasingconnectionten/search" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"query": "", "limit": 5, "offset": 0, "filter": {"solicitationNumber": "", "categories": [], "statuses": [{"value": "OPEN", "selected": true}], "agreementTypes": [], "solicitationTypes": [], "opportunityTypes": [], "deliveryRegions": [], "deliveryRegion": "", "organizations": [], "unspsc": [], "postDateRange": "$$custom", "closeDateRange": "$$custom", "onlyBookmarked": false, "onlyInterestExpressed": false}, "sortOptions": [{"field": "PostDateTime", "direction": "Desc"}]}'
```

Index of every published API: https://apiclay.com/llms.txt
