Flattened search for one-level-only tool integrations (e.g. Raya)

POST

/v1/search/flat

curl --request POST \
  --url https://search.example.com/v1/search/flat \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{ "additionalProperty": "example" }'

• Your deployment's public host (set per network instance)
• Local development

Same search as POST /v1/search, but the body is a FLAT object whose keys are dot-delimited canonical paths (a numeric segment is an array index) and whose values may all be strings. Leaves are JSON-parsed to restore real types, then validated against the canonical schema. Numeric-looking filter values are parsed as numbers; send a JSON-quoted string (e.g. “"560001"”) to keep one a string.

Authorizations

• apiKeyAuth

Request Body^required

Media typeapplication/json

object

key

additional properties

Example^generated

{
  "additionalProperty": "example"
}

Responses

200

Default Response

Media typeapplication/json

object

context

required

object

version

string

default: 1.0.0

messageId

required

string

>= 1 characters

timestamp

string

networkId

required

string

>= 1 characters

domain

required

string

>= 1 characters

itemType

required

string

>= 1 characters

message

required

object

items

required

Array<object>

object

item_network

required

string

item_domain

required

string

item_type

required

string

item_id

required

string

item_state

required

object

key

additional properties

item_locations

required

Array<object>

object

lat

required

number

lng

required

number

label

string

score

number

distanceMeters

number

meta

required

object

total

required

number

limit

required

number

offset

required

number

Example

{
  "context": {
    "version": "1.0.0"
  }
}

400

Default Response

Media typeapplication/json

object

error

required

string

message

required

string

Example^generated

{
  "error": "example",
  "message": "example"
}

401

Default Response

Media typeapplication/json

object

error

required

string

message

required

string

Example^generated

{
  "error": "example",
  "message": "example"
}

403

Default Response

Media typeapplication/json

object

error

required

string

message

required

string

Example^generated

{
  "error": "example",
  "message": "example"
}

404

Default Response

Media typeapplication/json

object

error

required

string

message

required

string

Example^generated

{
  "error": "example",
  "message": "example"
}

422

Default Response

Media typeapplication/json

object

error

required

string

message

required

string

Example^generated

{
  "error": "example",
  "message": "example"
}