Discover a Service and its Offerings

Start with a Service origin

ODP navigation starts from a Service origin. If the Agent already knows the origin, it can inspect the Service directly. Otherwise, it can use a directory or another trusted source to find candidate origins.

Find a Service in the Directory

Search the Directory with a Service-level query or filters. The result describes matching Services and returns the canonical origin needed for direct ODP navigation.

inflow odp directory search search

Inspect the Service Document

Inspect the selected origin before constructing a catalog request. The command retrieves and validates the current Service Document, resolves its endpoint base, and displays the operations and access requirements the Service advertises.

inflow odp inspect https://demo.inflowpay.ai

Choose an advertised operation

Select the operation that matches the Agent's immediate goal. An Agent must not probe an operation that the Service Document does not advertise.

When search-offerings is unavailable, use list-offerings for an unconstrained sequence. Do not infer a search endpoint from another Service or from a familiar URL pattern.

Browse or search Offerings

Listing is supported by every conformant Service. Search is an optional alternative for a Service that advertises it. Both operations return Terse Offerings intended for navigation and comparison.

inflow odp offerings list https://demo.inflowpay.ai

inflow odp offerings search https://demo.inflowpay.ai web

Preserve each returned Offering identifier exactly. The identifier belongs to the Service and is the value used by get-offering.

Retrieve the selected Offering

Use a returned identifier to retrieve the Full Offering. The response can include descriptions, images, pricing previews, custom attributes, and available Actions in addition to the fields shown in its Terse representation.

inflow odp offerings get https://demo.inflowpay.ai search

Continue paginated results

A list or search response can include an opaque next value. In interactive output, use the continuation command printed by the CLI. In structured output, pass the value back through --next without parsing, editing, or reconstructing it.

Review an Action before invocation

A Full Offering can advertise Actions that identify what may happen after discovery. Resolving an Action is read-only: it produces the target request contract without invoking the target.

inflow odp actions resolve https://demo.inflowpay.ai search invoke

Review the resolved method, URL, content type, and request schema before constructing a request. Enrollment, authentication, and payment are handled by the protocols protecting the target; discovering or resolving the Action does not perform them.

Next steps