Resolve a natural-language entity term to its id

curl --request GET \
  --url https://app.solya.app/api/resolve \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "brand-uuid-nike",
    "label": "Nike",
    "matchSource": "exact",
    "score": 1
  }
]

Resolve

Resolve a natural-language entity term to its id

Scored-cascade NL→id resolver for products, brands, and collections. Call this BEFORE filtering to turn a free-text term (e.g. ‘Nike’, ‘NK001’, ‘Summer 2025’) into a concrete entity id. Runs three layers: exact name match (score 1.0), code/identifier prefix match (score 0.95), then trigram fuzzy match (score ≤ 0.75). Results are ordered by score desc. For type=product each result also carries brandId for one-call pivot. Score semantics are aligned with /api/taxonomies/resolve.

GET

api

resolve

curl --request GET \
  --url https://app.solya.app/api/resolve \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "brand-uuid-nike",
    "label": "Nike",
    "matchSource": "exact",
    "score": 1
  }
]

Authorizations

Authorization

string

header

required

User session token issued by NextAuth. For human users accessing Solya via the web application.

Query Parameters

string

required

Natural-language entity term to resolve, e.g. 'Nike', 'NK001', 'Summer 2025'. Min 1 character.

Minimum string length: 1

type

enum<string>

required

Entity domain to search. 'product' resolves silver.products and returns brandId; 'brand' resolves silver.brands; 'collection' resolves silver.collections.

Available options:

product,

brand,

collection

limit

integer

default:5

Maximum candidates to return (1–20, default 5). Applied after cascade de-duplication.

Required range: 1 <= x <= 20

Response

Successful response

data

object[]

required

Show child attributes

success

enum<boolean>

required

Available options:

true

List budget planning periods for the organization Resolve a natural-language taxonomy term to its id/path