const dataBlockId = '22222222';
const response = await fetch(`https://service.pcibooking.net/api/dataBlock/${dataBlockId}`, {
method: 'PUT',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
Reference: 'updated_ref_001',
DataBlockLocation: 'US'
})
});
const data = await response.json();
console.log(data);
import requests
data_block_id = '22222222'
response = requests.put(
f'https://service.pcibooking.net/api/dataBlock/{data_block_id}',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'Reference': 'updated_ref_001',
'DataBlockLocation': 'US'
}
)
print(response.json())
{
"UserId": "Nadya",
"OwnerId": "Frodo",
"Id": "22222222",
"Reference": "my reference",
"ContentType": null,
"DataSize": null,
"CreationTime": "2019-01-16T11:21:25.3241104Z",
"LastAccessedTime": null,
"LastModifiedTime": null,
"DataBlockLocation": "DE"
}
{
"code": -125,
"message": "Bad input data",
"moreInfo": "...",
"errorList": null
}
Empty response body.
Authentication failed: the API key, session token or access token is missing or was not accepted.
See "Authentication and Permission Failures" on the Error Handling page.
Data Blocks
Update Data Block Details
Update the details and metadata of an existing data block.
PUT
/
api
/
dataBlock
/
{id}
const dataBlockId = '22222222';
const response = await fetch(`https://service.pcibooking.net/api/dataBlock/${dataBlockId}`, {
method: 'PUT',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
Reference: 'updated_ref_001',
DataBlockLocation: 'US'
})
});
const data = await response.json();
console.log(data);
import requests
data_block_id = '22222222'
response = requests.put(
f'https://service.pcibooking.net/api/dataBlock/{data_block_id}',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'Reference': 'updated_ref_001',
'DataBlockLocation': 'US'
}
)
print(response.json())
{
"UserId": "Nadya",
"OwnerId": "Frodo",
"Id": "22222222",
"Reference": "my reference",
"ContentType": null,
"DataSize": null,
"CreationTime": "2019-01-16T11:21:25.3241104Z",
"LastAccessedTime": null,
"LastModifiedTime": null,
"DataBlockLocation": "DE"
}
{
"code": -125,
"message": "Bad input data",
"moreInfo": "...",
"errorList": null
}
Empty response body.
Authentication failed: the API key, session token or access token is missing or was not accepted.
See "Authentication and Permission Failures" on the Error Handling page.
Data Block Tokenization Guide
Store and manage arbitrary data securely with GDPR-compliant storage locations
Error Responses
| HTTP Status | Error Code | Description |
|---|---|---|
| 400 | -125 | Validation error. The request body is missing or contains invalid fields. |
| 401 | none | Not authenticated. The API key is missing or invalid. The response body is empty. |
| 403 | -1003 | Not authorized. The authenticated user does not own this data block or lacks the CanWriteData permission. |
| 404 | -160 | Data block not found. No data block exists with the specified ID. |
| 500 | -150 | Internal system error. |
Parameter Constraints
| Parameter | Constraint |
|---|---|
Reference | Must match the pattern [a-zA-Z0-9_\-@#=\"']{0,64}. Letters, digits, underscore, hyphen, at-sign, hash, equals, double-quote, and single-quote only. Max 64 characters. |
DataBlockLocation | One of: US, IN, KR, SG, AU, JP, CA, DE, IE, GB, FR, BR. |
Parameters
Authentication
API key only. This endpoint does not accept access tokens or session tokens.string
required
Your API key prefixed with
APIKEY. Example: APIKEY your-api-key. The x-pcibooking-api-key header is also accepted. See the Authentication guide.Path Parameters
string
required
The ID of the data block returned in the create method.
Request Body
string
A reference value which can then be used to query for this card token.
string
default:"null"
The location to store this data block. Available locations: US, IN, KR, SG, AU, JP, CA, CN, DE, IE, GB, FR, BR. For the default location (Ireland), enter
null.const dataBlockId = '22222222';
const response = await fetch(`https://service.pcibooking.net/api/dataBlock/${dataBlockId}`, {
method: 'PUT',
headers: {
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
Reference: 'updated_ref_001',
DataBlockLocation: 'US'
})
});
const data = await response.json();
console.log(data);
import requests
data_block_id = '22222222'
response = requests.put(
f'https://service.pcibooking.net/api/dataBlock/{data_block_id}',
headers={
'Authorization': 'APIKEY your-api-key',
'Content-Type': 'application/json'
},
json={
'Reference': 'updated_ref_001',
'DataBlockLocation': 'US'
}
)
print(response.json())
Response
{
"UserId": "Nadya",
"OwnerId": "Frodo",
"Id": "22222222",
"Reference": "my reference",
"ContentType": null,
"DataSize": null,
"CreationTime": "2019-01-16T11:21:25.3241104Z",
"LastAccessedTime": null,
"LastModifiedTime": null,
"DataBlockLocation": "DE"
}
{
"code": -125,
"message": "Bad input data",
"moreInfo": "...",
"errorList": null
}
Empty response body.
Authentication failed: the API key, session token or access token is missing or was not accepted.
See "Authentication and Permission Failures" on the Error Handling page.