Get a return policy by supplier ID

curl --request GET \
  --url https://app.solya.app/api/return-policies/{id} \
  --header 'Authorization: Bearer <token>'

{
  "createdAt": "2026-01-10T08:00:00.000Z",
  "id": "policy-uuid-1",
  "organizationId": "org-uuid-123",
  "requiresConditionAssessment": true,
  "requiresReasonCode": false,
  "restockingFeePct": 5.5,
  "returnWindowDays": 30,
  "supplierId": "supplier-uuid-aaa",
  "updatedAt": null
}

GET

api

return-policies

{id}

Get a return policy by supplier ID

curl --request GET \
  --url https://app.solya.app/api/return-policies/{id} \
  --header 'Authorization: Bearer <token>'

{
  "createdAt": "2026-01-10T08:00:00.000Z",
  "id": "policy-uuid-1",
  "organizationId": "org-uuid-123",
  "requiresConditionAssessment": true,
  "requiresReasonCode": false,
  "restockingFeePct": 5.5,
  "returnWindowDays": 30,
  "supplierId": "supplier-uuid-aaa",
  "updatedAt": null
}

Authorizations

Authorization

string

header

required

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

Path Parameters

string

required

Supplier ID (the unique key for a return policy within an organization)

Minimum string length: 1

Response

Successful response

data

object

required

Show child attributes

success

enum<boolean>

required

Available options:

true

List return policies for the organization Upsert a return policy for a supplier