GraphQL API

The Aurea GraphQL API — schema, queries, mutations, and how to connect from the dashboard or any GraphQL client.

Endpoint

POST http://localhost:4000/graphql

The Apollo Sandbox playground is available at the same URL in a browser during development.

Currently open for development. A Clerk JWT guard is planned before production.

Represents an active immigration or relocation case managed by Aurea.

Prop

Type

Value	Description
`INTAKE`	Initial intake — case opened
`DOCUMENTS_PENDING`	Waiting for client documents
`SUBMITTED`	Documents submitted to authority
`IN_REVIEW`	Under review by authority
`APPROVED`	Case approved
`REJECTED`	Case rejected

Value	Label
`US_VISA`	US Visa Application
`DIGITAL_NOMAD_VISA`	Digital Nomad Visa
`CITIZENSHIP_APPLICATION`	Citizenship Application
`SPANISH_DRIVERS_LICENSE`	Spanish Driver's License Exchange

List all active cases.

query ListCases {
  cases {
    id
    clientName
    service
    status
    country
    createdAt
  }
}

Fetch a single case by ID.

query GetCase($id: ID!) {
  case(id: $id) {
    id
    clientName
    service
    status
    country
    createdAt
  }
}

Advance a case to its next lifecycle status following the progression:

INTAKE → DOCUMENTS_PENDING → SUBMITTED → IN_REVIEW → APPROVED

APPROVED and REJECTED are terminal states — calling advanceCaseStatus on them is a no-op (the status is returned unchanged).

mutation AdvanceCase($id: ID!) {
  advanceCaseStatus(id: $id) {
    id
    status
  }
}

curl -X POST http://localhost:4000/graphql \
  -H 'Content-Type: application/json' \
  -d '{"query":"{ cases { id clientName status } }"}'