Data Block Tokenization

The Data Block service lets you store any non-card data securely in PCI Booking’s infrastructure. Each data block gets a unique token ID, and the content is stored in a GDPR-compliant location of your choice. Data blocks can hold text, JSON, XML, images, PDFs, or any other content up to 50 MB per block.

Data blocks are not PCI compliant. Do not store credit card information in data blocks. Use PCI Booking’s card tokenization for card data.

How It Works

A data block has two parts: metadata (reference, location, timestamps) and content (the actual data). You create and manage them separately:

Create a data block to get a token ID. At this point you set the storage location and an optional reference for searching later.
Upload content to the data block using the token ID.
Download the content whenever you need it.

You can also update the metadata (reference, location), search across your data blocks by reference, and delete blocks you no longer need.

Storage Locations

When creating a data block, you choose where the data is stored. Available locations:

Code	Location
`IE`	Ireland (default)
`US`	United States
`DE`	Germany
`GB`	United Kingdom
`FR`	France
`CA`	Canada
`AU`	Australia
`SG`	Singapore
`JP`	Japan
`KR`	South Korea
`IN`	India
`CN`	China
`BR`	Brazil

Common Workflow

Store a document

# 1. Create the data block (metadata only)
curl -X POST https://service.pcibooking.net/api/dataBlock \
  -H "Authorization: APIKEY your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "Reference": "booking-12345",
    "DataBlockLocation": "DE"
  }'
# Response includes the token ID, e.g. "Id": "22222222"

# 2. Upload the content
curl -X PUT https://service.pcibooking.net/api/datablock/22222222/data \
  -H "Authorization: APIKEY your-api-key" \
  -H "Content-Type: application/pdf" \
  --data-binary @invoice.pdf

Retrieve a document

# Download by token ID
curl https://service.pcibooking.net/api/datablock/22222222/data \
  -H "Authorization: APIKEY your-api-key" \
  -o invoice.pdf

Find data blocks by reference

curl "https://service.pcibooking.net/api/dataBlock?reference=booking-12345" \
  -H "Authorization: APIKEY your-api-key"

Metadata Fields

Each data block tracks the following metadata:

Field	Description
`Id`	The unique token ID for this data block.
`Reference`	Your custom reference string for searching.
`DataBlockLocation`	The storage region code.
`ContentType`	The MIME type of the uploaded content. Set automatically on upload.
`DataSize`	The size of the uploaded content in bytes. Set automatically on upload.
`CreationTime`	When the data block was created.
`LastModifiedTime`	When the content was last uploaded or replaced.
`LastAccessedTime`	When the content was last downloaded.
`UserId`	The API user who created the data block.
`OwnerId`	The account that owns the data block.

Next Steps

Create a Data Block

Create a new data block and get its token ID.

Upload Content

Upload content to an existing data block.

Download Content

Download the content of a data block.

Search Data Blocks

Find data blocks by reference.

Start Here

Getting Started

Guides

Concepts

Capture Cards

Payments Library

Manage Tokens

Use Tokens

Account Configuration

Additional Functions

Reference

Support

Data Block Tokenization

How It Works

Storage Locations

Common Workflow

Store a document

Retrieve a document

Find data blocks by reference

Metadata Fields

Next Steps

Create a Data Block

Upload Content

Download Content

Search Data Blocks

​How It Works

​Storage Locations

​Common Workflow

​Store a document

​Retrieve a document

​Find data blocks by reference

​Metadata Fields

​Next Steps

Create a Data Block

Upload Content

Download Content

Search Data Blocks

How It Works

Storage Locations

Common Workflow

Store a document

Retrieve a document

Find data blocks by reference

Metadata Fields

Next Steps