# NFC

Preview. Tags and bindings. Runs in your test sandbox: nothing is issued, every pass is a test preview. Authenticate with `Authorization: Bearer $PASSBOOK_KEY`. Ids in the examples are placeholders: use the ids your sandbox returns.

> Preview. NFC is off until Apple approves it. You can define tag types now; a tag cannot be bound or tapped yet.

A tag type says how a kind of tag behaves: who it is for, how many a pass may hold, and whether staff confirm a tap. Passes bind to tags of a type once NFC opens.

## Create a tag type

`use` is `member`, `staff` or `visitor`. `perPass` is how many tags one pass may bind.

```json
{
  "name": "Member wristband",
  "use": "member",
  "perPass": 1,
  "confirm": "none"
}
```

## List your tag types

[List them](https://passbook.mobile/developers/reference/nfc#tagTypes-list). The new type is there with its settings.

## Change or archive one

Paste the tag type `id` into the path. `version` is the one the list shows: a stale version is refused. Archive stops new bindings and keeps the history.

```json
{ "version": 1, "name": "Member wristband (blue)", "perPass": 2 }
```

## Result

The list shows the tag type as you set it. Binding and tap calls are not part of the API yet, so there is nothing to scan: this guide ends at the definition.

## Operations

- [POST /api/v1/nfc/tag-types](https://passbook.mobile/developers/reference/nfc#tagTypes-create): Create a tag type (`pb.nfc.tagTypes.create`)
- [GET /api/v1/nfc/tag-types](https://passbook.mobile/developers/reference/nfc#tagTypes-list): Tag types of an organization (`pb.nfc.tagTypes.list`)
- [PATCH /api/v1/nfc/tag-types/{id}](https://passbook.mobile/developers/reference/nfc#tagTypes-update): Change a tag type (`pb.nfc.tagTypes.update`)

More guides: https://passbook.mobile/developers/guides
