Data Blocks

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 retrieve or 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. If you do not choose, the data is stored in your account’s country if it is in this list, otherwise in Ireland. Available locations:

Code	Location
`IE`	Ireland
`US`	United States
`DE`	Germany
`GB`	United Kingdom
`FR`	France
`CA`	Canada
`AU`	Australia
`SG`	Singapore
`JP`	Japan
`KR`	South Korea
`IN`	India
`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.

Get Data Block Details

Retrieve a data block’s metadata.

Update Data Block Details

Update a data block’s reference or location.

Delete Data Block

Permanently delete a data block.

Start Here

Getting Started

Concepts

Guides

Capture Cards

Payments Library

Manage Tokens

Use Tokens

Account Configuration

Additional Functions

Reference

Support

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

Get Data Block Details

Update Data Block Details

Delete Data Block

​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

Get Data Block Details

Update Data Block Details

Delete Data Block

How It Works

Storage Locations

Common Workflow

Store a document

Retrieve a document

Find data blocks by reference

Metadata Fields

Next Steps