Skip to main content
GET
/
v1
/
organizations
/
byOrganizationName
Get Organization by Name
curl --request GET \
  --url https://api.shoal.xyz/v1/organizations/byOrganizationName \
  --header 'Authorization: Bearer <token>'
Looks up an organization by name or known alias. Use this when you have a human-readable name (e.g. “Ethereum”, “Coinbase”) and need to resolve it to an organization ID for use with other endpoints.

​
Query Parameters

  • name (string, required)

​
Request

cURL
curl -X GET "https://api.shoal.xyz/v1/organizations/byOrganizationName?name=Org" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response

Returns an array of matching organizations in data (searched using case-insensitive partial matching). The response shape is { "data": [ ... ] }, where each element has the same fields as /v1/organizations/byOrganizationId.

​
Errors

  • 400 if name missing
  • 500 on internal server error