Error code

invalid_ref

Supply a valid, path-safe entity ref. A path or query parameter did not match the `{domain}:{key}` ref grammar.

What happened

The invalid value is named in message and usually repeated in refs[]. Hierarchical refs contain /; when a ref is placed in a URL path, those slashes must be encoded as %2F.

Do this next

Resolve free text first, then put the returned ref into the original request. Encode slashes only when the ref is used as a path segment.

Corrected request

bash


curl "https://api.cardog.app/v2/entities/resolve?q=2026%20Honda%20CR-V&domain=model-year" \
  -H "x-api-key: $CARDOG_API_KEY"

curl "https://api.cardog.app/v2/entities/model-year:honda%2Fcr-v%2F2026" \
  -H "x-api-key: $CARDOG_API_KEY"