GET /v1/x402-endpoints/by-url

Check if an x402 endpoint exists by URL

GET /v1/x402-endpoints/by-url
Check if an x402 endpoint exists by URL

Query Parameters

url string required query
Resource URL to check

Request Body

application/json

Responses

200 OK
application/json
code integer
data object
endpoint object
avgResponseMs integer
baseUrl string
=== ENDPOINT IDENTITY === BaseURL is the clean URL without query params (e.g., "https://api.example.com/search")
bodyParams object
category string
createdAt string
=== TIMESTAMPS ===
defaultBody object
defaultHeaders object
defaultQueryParams object
Default values (applied if user doesn't provide at runtime)
description string
exampleBody unknown
exampleOutput unknown
exampleQueryParams object
=== EXAMPLES ===
failureCount integer
headerParams object
id string
inputSummary string
lastCalledAt string
lastError string
lastErrorAt string
maxAllowedPrice string
Price protection (auto 5x of import price)
method string
GET, POST, PUT, DELETE
mimeType string
name string
=== METADATA ===
network string
outputSchema object
=== OUTPUT ===
outputSummary string
payTo string
price string
=== PAYMENT INFO ===
queryParams object
=== INPUT CONFIGURATION === CDP-aligned flat structure: {"paramName": {"type": "string", "description": "...", "required": true}}
source string
Enum: user_import, cdp_bazaar
spentByToken object
Multi-token spending tracker: {"0x833...": "50000", "0xb3b...": "1000000000000000000"}
successCount integer
=== STATS ===
tags string[]
Array of:
tokenAddress string
tokenDecimals integer
tokenSymbol string
totalCalls integer
updatedAt string
useCases string[]
=== AI FIELDS ===
Array of:
exists boolean
message string
requestId string
400 Bad Request 
curl -X GET 'https://api.example.com/v1/x402-endpoints/by-url?url=string' \  -H 'Authorization: Bearer YOUR_API_TOKEN' \  -H 'Content-Type: application/json' \  -d '{}'
const response = await fetch('https://api.example.com/v1/x402-endpoints/by-url?url=string', {  method: 'GET',  headers: {      "Authorization": "Bearer YOUR_API_TOKEN",      "Content-Type": "application/json"  },  body: JSON.stringify({})});const data = await response.json();console.log(data);
import requestsheaders = {    'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://api.example.com/v1/x402-endpoints/by-url?url=string', headers=headers, json={})print(response.json())
package mainimport (	"fmt"	"io"	"net/http"	"strings")func main() {	body := strings.NewReader(`{}`)	req, _ := http.NewRequest("GET", "https://api.example.com/v1/x402-endpoints/by-url?url=string", body)	req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")	req.Header.Set("Content-Type", "application/json")	resp, _ := http.DefaultClient.Do(req)	defer resp.Body.Close()	result, _ := io.ReadAll(resp.Body)	fmt.Println(string(result))}
200 Response 
{  "code": 200,  "data": {    "endpoint": {      "avgResponseMs": 123,      "baseUrl": "<string>",      "bodyParams": "<object>",      "category": "<string>",      "createdAt": "<string>",      "defaultBody": "<object>",      "defaultHeaders": "<object>",      "defaultQueryParams": "<object>",      "description": "<string>",      "exampleBody": "<unknown>",      "exampleOutput": "<unknown>",      "exampleQueryParams": "<object>",      "failureCount": 123,      "headerParams": "<object>",      "id": "<string>",      "inputSummary": "<string>",      "lastCalledAt": "<string>",      "lastError": "<string>",      "lastErrorAt": "<string>",      "maxAllowedPrice": "<string>",      "method": "<string>",      "mimeType": "<string>",      "name": "<string>",      "network": "<string>",      "outputSchema": "<object>",      "outputSummary": "<string>",      "payTo": "<string>",      "price": "<string>",      "queryParams": "<object>",      "source": "user_import",      "spentByToken": "<object>",      "successCount": 123,      "tags": [        "<string>"      ],      "tokenAddress": "<string>",      "tokenDecimals": 123,      "tokenSymbol": "<string>",      "totalCalls": 123,      "updatedAt": "<string>",      "useCases": [        "<string>"      ]    },    "exists": true  },  "message": "success",  "requestId": "abc-123"}
Previous POST /v1/x402-endpoints
Next POST /v1/x402-endpoints/execute