# Get block

Fetch a single Are.na block by block ID or block URL.

- Platform: [Are.na](https://docs.upscrape.com/docs/platforms/arena)
- Capability ID: `arena.block.get`
- Cost: 1 credit per request
- Maximum runtime: 10 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "block_id": "41532780"
  },
  "capability": "arena.block.get"
}'
```

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `block_id` | `string` | Yes | Are.na block ID or block URL |

### Example input

```json
{
  "block_id": "41532780"
}
```

## Response

Successful output is returned in `results[0].data`.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "class": "Link",
  "created_at": "2025-12-03T04:09:37+00:00",
  "description": "<p>‘T’ Space is a non-profit art gallery in Rhinebeck, NY. Programs include an exhibition and performance series, residency for emerging architects, and more.</p>",
  "href": "/block/41532780",
  "id": 41532780,
  "image_url": "https://images.are.na/[redacted:token]==?bc=0",
  "source": {
    "title": "‘T’ Space Rhinebeck",
    "url": "https://tspacerhinebeck.org"
  },
  "source_url": "https://tspacerhinebeck.org",
  "title": "‘T’ Space Rhinebeck",
  "updated_at": "2026-08-12T12:57:40+00:00",
  "user": {
    "href": "/kiki-dot-directory",
    "id": 829225,
    "name": "kiki dot directory",
    "slug": "kiki-dot-directory"
  }
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `class` | `string` | Link |
| `created_at` | `string` | 2025-12-03T04:09:37+00:00 |
| `description` | `string` | <p>‘T’ Space is a non-profit art gallery in Rhinebeck, NY. Programs inc… |
| `href` | `string` | /block/41532780 |
| `id` | `integer` | 41532780 |
| `image_url` | `string` | https://images.are.na/[redacted:token]==?bc=0 |
| `source` | `object` | 2 fields |
| `source.title` | `string` | ‘T’ Space Rhinebeck |
| `source.url` | `string` | https://tspacerhinebeck.org |
| `source_url` | `string` | https://tspacerhinebeck.org |
| `title` | `string` | ‘T’ Space Rhinebeck |
| `updated_at` | `string` | 2026-08-12T12:57:40+00:00 |
| `user` | `object` | 4 fields |
| `user.href` | `string` | /kiki-dot-directory |
| `user.id` | `integer` | 829225 |
| `user.name` | `string` | kiki dot directory |
| `user.slug` | `string` | kiki-dot-directory |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)