# Create inquiry

Create a new inquiry for card metadata based on either a PAN, an existing PCI token, or a network token.

Endpoint: POST /api/metadata/inquiries
Version: EAP
Security: APIKey, AdminToken

## Header parameters:

  - `x-idempotency-key` (string)
    Optional idempotency key to prevent duplicate processing
    Example: "order_12345_retry_001"

## Request fields (application/json):

  - `source` (object, required)

## Response 200 fields (application/json):

  - `bin` (string, required)
    Example: "411111"

  - `scheme` (string, required)
    Enum: "visa", "mastercard", "american express", "discover", "diners club", "jcb", "unionpay"

  - `type` (string)
    Enum: "credit", "debit", "prepaid", "other"

  - `segment` (string)
    Enum: "consumer", "commercial"

  - `billing_currency_code` (string)
    Example: "EUR"

  - `issuer_name` (string)
    Example: "Starfish Bank"

  - `issuer_country_code` (string)
    Example: "DE"

  - `product_code` (string)
    Example: "VISA-PLATINUM"

  - `product_name` (string)
    Example: "Visa Platinum Card"

## Response 401 fields (application/json):

  - `code` (integer)
    The corresponding HTTP status code for the error

  - `classifier` (string)
    Technical code that helps to identify the error

  - `message` (string)
    Human readable representation of the error

## Response 403 fields (application/json):

  - `code` (integer)
    The corresponding HTTP status code for the error

  - `classifier` (string)
    Technical code that helps to identify the error

  - `message` (string)
    Human readable representation of the error

## Response 409 fields (application/json):

  - `code` (integer)
    The corresponding HTTP status code for the error

  - `classifier` (string)
    Technical code that helps to identify the error

  - `message` (string)
    Human readable representation of the error

## Response 422 fields (application/json):

  - `code` (integer)
    The corresponding HTTP status code for the error

  - `classifier` (string)
    Technical code that helps to identify the error

  - `message` (string)
    Human readable representation of the error

  - `validation_errors` (array)

  - `validation_errors.path` (string)
    Json-path in the request which points to the validation error

  - `validation_errors.message` (string)
    Human readable validation message