toc

API reference

A full reference of the Evervault API.

Authentication

The Evervault API is authenticated using an API key. You can find your key in the Settings page for your team. Each key is scoped per team.

To authenticate requests, append an API-Key header to your request with the value set to the API key copied from the previous step.

Encrypt data

With team ID

Encrypt any data by POSTing a JSON payload to the following URL:

http
POST https://encrypt.evervault.com/:teamId
Content-Type: application/json
{
"ssn": "123-45-6789",
"creditCard": {
"number": "4242 4242 4242 4242",
"cvv": "123",
"expiry": "03/24"
}
}

Here’s how to run with cURL:

bash
curl --request POST \
--url https://encrypt.evervault.com/e1e67f4f0659 \
--header 'Content-Type: application/json' \
--data '{
"ssn": "123-45-6789",
"creditCard": {
"number": "4242 4242 4242 4242",
"cvv": "123",
"expiry": "03/24"
}
}'

With API key

Encrypt any data by POSTing a JSON payload to the following URL:

http
POST https://encrypt.evervault.com/
API-Key: <YOUR_API_KEY>
Content-Type: application/json
{
"ssn": "123-45-6789",
"creditCard": {
"number": "4242 4242 4242 4242",
"cvv": "123",
"expiry": "03/24"
}
}

Here’s how to run with cURL:

bash
curl --request POST \
--url https://encrypt.evervault.com/ \
--header 'API-Key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"ssn": "123-45-6789",
"creditCard": {
"number": "4242 4242 4242 4242",
"cvv": "123",
"expiry": "03/24"
}
}'

Run a Cage

Run a Cage by POSTing a payload to the following URL:

http
POST https://run.evervault.com/:cageName
API-Key: <YOUR_API_KEY>
Content-Type: application/json
{
"ssn": "ev:debug:UJJn8/4KRA8f+G47:A1Sq3fd2OBst4zsZNBbZex9XSEItenNkt99M1EBVehgy:BNOnINL4WcCLr5b70CRbAs0VrH6K4wO6Tw==:$",
"creditCard": {
"number": "ev:debug:fHs4yviecz4ui23O:A3MRMElymESwgydJE5z3B7cPUyC0K6TT5THYkylAEb0E:9TTGYz0CDTwqfBXrEGNw0dLCBLuh29wlQ0P+tyBlbkNYGSY=:$",
"cvv": "ev:debug:ZA7b52W/h0PVBbhx:A1Sq3fd2OBst4zsZNBbZex9XSEItenNkt99M1EBVehgy:yMTM47CmzqefKVedyokvKfPXZA==:$",
"expiry": "ev:debug:OZxh1MEomn+X7M0X:A3MRMElymESwgydJE5z3B7cPUyC0K6TT5THYkylAEb0E:m8e0b4AUiadzmOuvUcmXBJZH7qLr:$"
}
}

Here’s how to run a Cage with cURL:

bash
curl --request POST \
--url https://run.evervault.com/demo-cage \
--header 'API-Key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data '{
"ssn": "ev:debug:UJJn8/4KRA8f+G47:A1Sq3fd2OBst4zsZNBbZex9XSEItenNkt99M1EBVehgy:BNOnINL4WcCLr5b70CRbAs0VrH6K4wO6Tw==:$",
"creditCard": {
"number": "ev:debug:fHs4yviecz4ui23O:A3MRMElymESwgydJE5z3B7cPUyC0K6TT5THYkylAEb0E:9TTGYz0CDTwqfBXrEGNw0dLCBLuh29wlQ0P+tyBlbkNYGSY=:$",
"cvv": "ev:debug:ZA7b52W/h0PVBbhx:A1Sq3fd2OBst4zsZNBbZex9XSEItenNkt99M1EBVehgy:yMTM47CmzqefKVedyokvKfPXZA==:$",
"expiry": "ev:debug:OZxh1MEomn+X7M0X:A3MRMElymESwgydJE5z3B7cPUyC0K6TT5THYkylAEb0E:m8e0b4AUiadzmOuvUcmXBJZH7qLr:$"
}
}'
warningThis command will not encrypt your data before sending it to the Cage.

List Cages

List all the Cages for a team by sending a GET request:

http
GET https://api.evervault.com/cages
API-Key: <YOUR_API_KEY>

Here’s how to run with cURL:

bash
curl --request GET \
--url https://api.evervault.com/cages \
--header 'API-Key: <YOUR_API_KEY>'