Skip to main content
POST
/
v1
/
dict
/
claims
Create a Claim
curl --request POST \
  --url https://plugin-pix-indirect.api.lerian.net/v1/dict/claims \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Account-Id: <x-account-id>' \
  --data '
{
  "key": "+5561988887777",
  "type": "OWNERSHIP"
}
'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "bacenClaimId": "cc91b1b0-8465-44b1-a760-15dd3717ea9b",
  "key": "+5561988887777",
  "keyType": "PHONE",
  "type": "OWNERSHIP",
  "status": "OPEN",
  "donorParticipant": "30306294",
  "resolutionPeriodEnd": "2024-01-22T10:30:00Z",
  "completionPeriodEnd": "2024-01-29T10:30:00Z",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-Account-Id
string
required

Unique identifier of the Midaz Ledger Account (UUID format).

Body

application/json
​
key
string
required

Pix key value to claim.

Example:

"+5561988887777"

​
type
enum<string>
required

Type of claim.

Available options:
OWNERSHIP,
PORTABILITY
Example:

"OWNERSHIP"

Response

Claim created successfully.

​
id
string

Internal UUID of the claim.

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
bacenClaimId
string

BACEN DICT identifier for this claim.

Example:

"cc91b1b0-8465-44b1-a760-15dd3717ea9b"

​
key
string

The Pix key value being claimed.

Example:

"+5561988887777"

​
keyType
string

Type of Pix key.

Example:

"PHONE"

​
type
enum<string>

Type of claim.

Available options:
OWNERSHIP,
PORTABILITY
Example:

"OWNERSHIP"

​
status
enum<string>

Current status of the claim.

Available options:
OPEN,
WAITING_RESOLUTION,
CONFIRMED,
CANCELLED,
COMPLETED
Example:

"OPEN"

​
donorParticipant
string

ISPB of the donor PSP.

Example:

"30306294"

​
resolutionPeriodEnd
string<date-time>

Deadline for donor response (D+7 from creation).

Example:

"2024-01-22T10:30:00Z"

​
completionPeriodEnd
string<date-time>

Deadline for claim completion (D+14 from creation).

Example:

"2024-01-29T10:30:00Z"

​
createdAt
string<date-time>

Timestamp when the claim was created.

Example:

"2024-01-15T10:30:00Z"

​
updatedAt
string<date-time>

Timestamp when the claim was last updated.

Example:

"2024-01-15T10:30:00Z"