---
title: Get bot details
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Radar](https://developers.cloudflare.com/api/resources/radar)
[Bots](https://developers.cloudflare.com/api/resources/radar/subresources/bots)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Get bot details
GET/radar/bots/{bot\_slug}
Retrieves the requested bot information.
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`User Details Write``User Details Read`
##### P ath ParametersExpand Collapse
bot\_slug: string
Bot slug.
maxLength100
[Link to this property](<#(resource)%20radar.bots%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20bot_slug%20%3E%20(schema)>)
##### Q uery ParametersExpand Collapse
format: optional "JSON"or "CSV"
Format in which results will be returned.
One of the following:
"JSON"
Link to this property
"CSV"
Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20format%20%3E%20(schema)>)
##### ReturnsExpand Collapse
result: object {bot }
bot: object {category, description, kind, 7 more }
category: string
The category of the bot.
Link to this property
description: string
A summary for the bot (e.g., purpose).
Link to this property
Deprecatedkind: string
The kind of the bot.
Link to this property
name: string
The name of the bot.
Link to this property
operator: string
The organization that owns and operates the bot.
Link to this property
operatorUrl: string
The link to the bot documentation.
Link to this property
slug: string
A kebab-case identifier derived from the bot name.
Link to this property
userAgentPatterns: array of string
Link to this property
userAgents: array of string
Link to this property
signatureAgentUrl: optional string
The URL of the agent’s Web Bot Auth resource. Null for bots not verified via request signature.
Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.bots%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
success: boolean
[Link to this property](<#(resource)%20radar.bots%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### Get bot details
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/radar/bots/$BOT_SLUG \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```
200 example
```
{
"result": {
"bot": {
"category": "AI_CRAWLER",
"description": "OpenAI/ChatGPT's web crawler",
"kind": "AGENT",
"name": "GPTBot",
"operator": "OpenAI",
"operatorUrl": "https://platform.openai.com/docs/bots",
"slug": "gptbot",
"userAgentPatterns": [
"GPTBot"
],
"userAgents": [
"GPTBot"
],
"signatureAgentUrl": "https://example.com/signature-agent"
}
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"result": {
"bot": {
"category": "AI_CRAWLER",
"description": "OpenAI/ChatGPT's web crawler",
"kind": "AGENT",
"name": "GPTBot",
"operator": "OpenAI",
"operatorUrl": "https://platform.openai.com/docs/bots",
"slug": "gptbot",
"userAgentPatterns": [
"GPTBot"
],
"userAgents": [
"GPTBot"
],
"signatureAgentUrl": "https://example.com/signature-agent"
}
},
"success": true
}
```