GET
/
benefits
/
{benefit_id}
cURL
curl --request GET \
  --url http://localhost:8080/benefits/{benefit_id} \
  --header 'Authorization: Bearer <token>'
{
  "benefit_details": {
    "benefit_type": "consultation",
    "description": "<string>"
  },
  "benefit_type": "consultation",
  "created_at": "<string>",
  "id": "<string>",
  "last_modified_at": "<string>",
  "name": "<string>",
  "provider_id": "<string>",
  "provider_name": "<string>",
  "status": "active"
}

Authorizations

​
Authorization
string
header
required

JWT access token. Obtain from /auth/otp/verify endpoint.

Path Parameters

​
benefit_id
string
required

Benefit ID

Response

Benefit found

​
benefit_details
object
required

Typed payload stored in benefits.benefit_details (JSONB).

Discriminated by the "benefit_type" JSON key, matching common_enums::BenefitType.

​
benefit_type
enum<string>
required

Kind of benefit offered by a provider.

Available options:
consultation,
insurance_policy
​
created_at
string
required
​
id
string
required
​
last_modified_at
string
required
​
name
string
required
​
provider_id
string
required
​
provider_name
string
required
​
status
enum<string>
required

Benefit lifecycle status.

Available options:
active,
inactive