API documentation

Everything you need to integrate with the Gini v2 Third-Party API.

API reference

Influencers

Create and manage your influencers / affiliates and their referral codes, matching the dashboard's Influencers screen.

List influencers

Your influencers, newest first. Returns name, email, code, is_active, and the attributed order count. Paginated.

GET /api/v2.0/third-party/influencers

Signed

Get one

A single record by its numeric id. 404 if it is not yours.

GET /api/v2.0/third-party/influencers/{influencer}

Signed

Create

POST /api/v2.0/third-party/influencers

Signed

Body parameters

Field	Type	Required	Description
`name`	string	Required	2–155 chars.
`email`	string	Optional	Optional; stored blank as null.
`code`	string	Required	2–50 chars, letters/numbers/dashes/underscores. Unique across all influencers; stored upper-cased.
`is_active`	boolean	Optional	Defaults to true.

Notes

Send the body as JSON (Content-Type: application/json) so every field is covered by the signature — a form-encoded body is signed as empty.
An influencer with attributed orders cannot be deleted (HTTP 422) — order history keeps its reference.
List supports search, active_only, sort (name|code|orders_count|is_active|created_at) and per_page.
POST /influencers is idempotent — send an Idempotency-Key header.

Update

Partial — send only the fields you are changing. 404 if it is not yours.

PUT /api/v2.0/third-party/influencers/{influencer}

Signed

Delete

DELETE /api/v2.0/third-party/influencers/{influencer}

Signed