---
updatedAt: 2026-07-02T13:23:40.000Z
agentTools:
  projectIndex: https://docs.mesh.complyadvantage.com/llms.txt
---

# Retrieve a risk word

Retrieves a single risk word from a custom list of type `RISK_WORD` by its identifier.


You need "Access to custom lists for customer screening" enabled and the "Create, update, and delete custom lists and their entities, and download entities" permission to use this endpoint.

# OpenAPI definition

```json
{
  "components": {
    "schemas": {
      "customlist_ProblemDetailErrorResponse": {
        "additionalProperties": true,
        "properties": {
          "detail": {
            "nullable": true,
            "type": "string"
          },
          "identifier": {
            "format": "uuid",
            "type": "string"
          },
          "instance": {
            "format": "uri",
            "nullable": true,
            "type": "string"
          },
          "status": {
            "format": "int32",
            "nullable": true,
            "type": "integer"
          },
          "timestamp": {
            "format": "date-time",
            "type": "string"
          },
          "title": {
            "nullable": true,
            "type": "string"
          },
          "type": {
            "format": "uri",
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "identifier",
          "timestamp"
        ],
        "type": "object"
      },
      "customlist_RiskWordDTO": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "type": "string"
          },
          "created_by": {
            "format": "uuid",
            "type": "string"
          },
          "identifier": {
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "type": "string"
          },
          "updated_by": {
            "format": "uuid",
            "nullable": true,
            "type": "string"
          },
          "word": {
            "type": "string"
          }
        },
        "required": [
          "created_at",
          "created_by",
          "identifier",
          "updated_at",
          "word"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "description": "HTTP Bearer Token Authentication",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "title": "Mesh API",
    "version": "v2.0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/v2/custom-lists/{custom_list_id}/risk-word/{id}": {
      "get": {
        "description": "Retrieves a single risk word from a custom list of type `RISK_WORD` by its identifier.\n\n\nYou need \"Access to custom lists for customer screening\" enabled and the \"Create, update, and delete custom lists and their entities, and download entities\" permission to use this endpoint.",
        "operationId": "customListAPIFetchRiskWordById",
        "parameters": [
          {
            "description": "The identifier of the custom list containing the risk word to retrieve.",
            "example": "00000000-0000-0000-0000-000000000000",
            "in": "path",
            "name": "custom_list_id",
            "required": true,
            "schema": {
              "format": "uuid",
              "type": "string"
            }
          },
          {
            "description": "The identifier of the risk word to retrieve",
            "example": "risk_word_1",
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/customlist_RiskWordDTO"
                }
              }
            },
            "description": "The requested risk word has been found and returned"
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/customlist_ProblemDetailErrorResponse"
                }
              }
            },
            "description": "The custom list id is expected to be a UUID, or the custom list is not of type RISK_WORD"
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/customlist_ProblemDetailErrorResponse"
                }
              }
            },
            "description": "The requested risk word could not be found."
          }
        },
        "summary": "Retrieve a risk word",
        "tags": [
          "Custom Lists"
        ]
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "servers": [
    {
      "description": "ComplyAdvantage Mesh API",
      "url": "https://api.mesh.complyadvantage.com"
    }
  ],
  "tags": [
    {
      "name": "Custom Lists"
    }
  ]
}
```