Read what the share's person shared

Módulo Identity

GET/work-detail-shares/{id}/detailsworkDetailShares.details

For a member of the engaging org: the shared categories the caller's project capabilities cover (safety readers and engagement editors for emergency contacts, engagement readers and shift editors for uniform sizes, hospitality readers for the rest), through `app.shared_work_details`. Nothing is returned once the share is revoked or the engagement is Complete or Canceled. The passport number is always masked. Each read is logged in the person's access log and the org's audit ledger. A rule that refuses the request returns 422 with `refusal` and `reason`.

Requiere la capacidad opportunities.engagement.read.
Alcances de OAuth: opportunities.
Estados de error: 400, 401, 404, 422, 429. Los errores son detalles de problema RFC 9457.

Parámetros de ruta y de consulta

workDetailShares.details: Parámetros de ruta y de consulta
Campo	Tipo	Obligatorio	Descripción
id	string (uuid)	Sí	Identifier of the work detail share.

Respuesta 200: SharedWorkDetails

workDetailShares.details: SharedWorkDetails
Campo	Tipo	Obligatorio	Descripción
engagement_id	string (uuid)	Sí	Engagement.
person_id	string (uuid) \| null	Sí	Person the engagement names.
org_id	string (uuid)	Sí	Engaging org.
work_detail_share_id	string (uuid) \| null	Sí	Live share; null when none stands.
shared_at	string (date-time) \| null	Sí	When the share was given.
sharing_open	boolean	Sí	The engagement is Onboarding to Closing; a closed engagement reads nothing.
categories	array of WorkDetailCategory	Sí	Categories the person shared.
readable	array of WorkDetailCategory	Sí	Shared categories the caller's project capabilities cover; the others come back null.
emergency_contacts	array of SharedEmergencyContact \| null	Sí
uniform	SharedUniformSizes \| null	Sí
dietary	SharedDietaryNeeds \| null	Sí
accessibility	SharedAccessibilityNeeds \| null	Sí
travel	SharedTravelProfile \| null	Sí
passport	SharedPassport \| null	Sí

{
  "engagement_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "person_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "org_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "work_detail_share_id": "0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f",
  "shared_at": "2026-10-08T14:30:00Z",
  "sharing_open": true,
  "categories": [
    "Dietary Needs"
  ],
  "readable": [
    "Dietary Needs"
  ],
  "emergency_contacts": [
    {
      "full_name": "Marco Marchetti",
      "relationship": "Brother",
      "phone_e164": "+13055550142",
      "alternate_phone_e164": "+13055550142",
      "email": "marco@example.com",
      "sort_order": 0
    }
  ],
  "uniform": {
    "shirt_size": "XXS",
    "jacket_size": "XXS",
    "pants_size": "32x32",
    "shoe_size": "US 10.5",
    "glove_size": "XXS",
    "hat_size": "7 1/4",
    "uniform_notes": "Prefers a relaxed cut."
  },
  "dietary": {
    "dietary_needs": [
      "Vegetarian"
    ],
    "allergies": "Peanuts, severe",
    "dietary_notes": "No pork."
  },
  "accessibility": {
    "accessibility_needs": [
      "Step-Free Access"
    ],
    "accessibility_notes": "Needs a seat near the stage door."
  },
  "travel": {
    "seat_preference": "Window",
    "meal_preference": "Vegetarian (VGML)",
    "home_airport": "MIA",
    "loyalty_programs": [
      {
        "program_kind": "Airline",
        "program_name": "SkyMiles",
        "member_number": "SM-0000-TEST"
      }
    ]
  },
  "passport": {
    "passport_number": null,
    "passport_number_last4": "TEST",
    "passport_number_masked": true,
    "passport_issuing_country": "US",
    "passport_expires_on": "2026-10-08",
    "passport_name": "IVY MARCHETTI"
  }
}

Ejemplos de código

curl -X GET "$XOS_BASE_URL/work-detail-shares/0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f/details" \
  -H "Authorization: Bearer $XOS_API_KEY"

const { data } = await xos.workDetailShares.details("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f");

response = xos.work_detail_shares.details("0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f")

xos work-detail-shares details 0192f1e2-7c3a-7b4d-9e8f-1a2b3c4d5e6f