# Officeworks Stores API Documentation

<p><strong>Officeworks Stores API Documentation</strong> Find public stores by postcode, suburb or store id, with optional stock for one sku. Supply at least one location parameter. 1 credit per request. Failed requests are never billed.</p>

- **Documentation:** [https://scrappa.co/docs/officeworks-api/officeworks_stores](https://scrappa.co/docs/officeworks-api/officeworks_stores)
- **API group:** Officeworks API
- **Endpoint:** `GET https://scrappa.co/api/officeworks/stores`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `postcode` | string | No | Four digit postcode |
| `suburb` | string | No | Suburb name |
| `storeId` | string | No | Store id, e.g. W251 |
| `sku` | string | No | Optional sku for store stock |

## Example response

```json
{
    "data": {
        "count": 0,
        "stores": []
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "catalogue_stores"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | Supply a postcode, suburb or store id. Failed requests are not billed. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
