---
title: "FetchByCustom"
url: "https://nov18-dev.movespot.fyi/apis/konnect-kong-identity-auth-api-dev-0/versions/95ca6cb9-c471-4475-a351-61326ecea57b/schemas/FetchByCustom"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-kong-identity-auth-api-dev-0/versions/95ca6cb9-c471-4475-a351-61326ecea57b.md

# FetchByCustom

Looks up a principal by an arbitrary key/value pair.

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Konnect Kong Identity auth api
  version: 0.0.2
servers:
  - url: https://us.api.konghq.com
    description: United-States Production region
  - url: https://eu.api.konghq.com
    description: Europe Production region
  - url: https://au.api.konghq.com
    description: Australia Production region
  - url: https://me.api.konghq.com
    description: Middle-East Production region
  - url: https://in.api.konghq.com
    description: India Production region
  - url: https://sg.api.konghq.com
    description: Singapore Production region
components:
  schemas:
    FetchByCustom:
      description: Looks up a principal by an arbitrary key/value pair.
      type: object
      properties:
        type:
          type: string
          enum:
            - custom
        key:
          description: The custom key to match against.
          type: string
          minLength: 1
        value:
          description: The value of the identity to match against.
          type: string
          minLength: 1
      required:
        - type
        - key
        - value
```
