---
title: "Create Credit Lock"
method: POST
path: "/v2/credits/locks"
tags: ["V2Credits"]
---

# Create Credit Lock

`POST /v2/credits/locks`

## Request

- Base URL: `https://api.explorium.ai`
- URL: `https://api.explorium.ai/v2/credits/locks`
- Auth: one of:
  - API key in header `api_key`
  - API key in header `api_key`
- TypeScript: <https://skmtc.dev/explorium-ai/apis/partner-service/docs/v2/credits/locks/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- V2CreditLockRequest
  - `entity_type` 'business_data' | 'prospect_data' | 'business_event_data' | 'prospect_event_data' | 'custom_signals_data' | 'business_data_free_first_visit' | 'prospect_data_free_first_visit', required: An enumeration.
  - `operation_types` CreditServiceOperationType[], required
  - `entities_amount` integer, required
  - `endpoint_name` string
  - `ttl_hours` integer

## Response `201`

Successful Response

- CreditLockResponse
  - `credit_lock_id` string, required
  - `status` string, required
  - `credit_cost` integer
  - `credit_costs` object
  - `locked_credits` integer, required
  - `consumed_credits` integer
  - `released_credits` integer
  - `remaining_credits` integer
  - `expires_at` string, date-time

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-22** `74425433e0ae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/explorium-ai/apis/partner-service/changes/v2/credits/locks/post.md)

---

[API](https://skmtc.dev/explorium-ai/apis/partner-service.md) - [All operations](https://skmtc.dev/explorium-ai/apis/partner-service/llms.txt) - [OpenAPI document](https://skmtc.dev/explorium-ai/apis/partner-service/revisions/3e8ca10a58ea?raw)