Skip to main content
GET
/
data-users
/
{duid}
Look Up a Data User by DUID
curl --request GET \
  --url https://api.central.consent/v1/data-users/{duid} \
  --header 'Authorization: Bearer <token>'
{
  "response": {
    "resource": "/v1/data-users/duid_691df0c788ca043403b7fa90",
    "timestamp": "2026-03-18T10:00:00Z",
    "transaction-id": "tid_abc123def456abc123def456"
  },
  "data-user": {
    "duid": "duid_691df0c788ca043403b7fa90",
    "display-name": "Bright Energy Services Ltd",
    "status": "active",
    "registered-at": "2024-01-15T09:00:00Z",
    "contact-url": "https://bright-energy.com/contact",
    "data-types-supported": [
      "HH-CONSUMPTION",
      "HH-EXPORT",
      "TARIFF-IMPORT"
    ]
  }
}

Authorizations

Authorization
string
header
required

JWT from GET /auth/token. Pass as Authorization: Bearer <token>. Expires after 7200s.

Path Parameters

duid
string
required

The Data User identifier to look up. Format: duid_ followed by 24 lowercase hex characters.

Unique identifier for a registered Data User organisation, issued by the register at onboarding.

Pattern: ^duid_[0-9a-f]{24}$
Example:

"duid_691df0c788ca043403b7fa90"

Response

Data User found and returned.

response
object
required
data-user
object
required

Public directory entry for a registered Data User organisation. Returned by GET /data-users/{duid}.

Last modified on March 25, 2026