Get the ownership state

GEThttps://api.fortwatch.ai/app/assets/{id}/ownership

Scope assets:readOperation ID getAssetOwnership

Whether the asset's ownership is proven and how, with the DNS TXT record or the HTTP file that proves it.

Parameters

Name	In	Type	Description
`id`required	path	integer

Example request

curl -X GET "https://api.fortwatch.ai/app/assets/42/ownership" \
  -H "Authorization: Bearer $FORTWATCH_API_KEY"

Response 200

The request succeeded.

Field	Type	Description
`verified`required	boolean
`verifiedAt`required	string (date-time) \| null
`method`required	object \| null
`challenge`required	object
`token`required	string
`methods`required	string[]
`dns`required	object
`host`required	string
`type`required	string
`value`required	string
`http`required	object
`url`required	string
`path`required	string
`content`required	string

json

{
  "verified": true,
  "verifiedAt": "2026-10-16T12:00:00.000Z",
  "method": {},
  "challenge": {
    "token": "string",
    "methods": [
      "string"
    ],
    "dns": {
      "host": "app.example.com",
      "type": "string",
      "value": "app.example.com"
    },
    "http": {
      "url": "string",
      "path": "string",
      "content": "string"
    }
  }
}

Errors

`400`	The request is not valid: a field is missing or has the wrong shape (the message names it).
`401`	No valid credentials: the API key or access token is missing, revoked or expired (INVALID_API_KEY, INVALID_TOKEN).
`403`	Not allowed: the key or token lacks this scope (SCOPE_REQUIRED), the route is dashboard-only (SESSION_REQUIRED), or a plan limit applies.
`404`	Not found in your workspace.
`429`	Too many requests (RATE_LIMITED): wait the seconds Retry-After gives.

Every code is explained in Errors.

This page as Markdown