PAIDIDEAS / NEXUS
API Docs →
v1.0.0-rc1 · release-candidate · API v1

PAIDIDEAS Nexus

The central backend platform and single source of truth for every website, mobile app, and service in the PAIDIDEAS ecosystem. API-first, modular, secure. This is not a website — it is the infrastructure every frontend connects to.

Foundation endpoints

  • GET/api/v1/health
    Liveness and readiness check
  • GET/api/v1/version
    Platform version and build metadata
  • GET/api/v1/openapi.json
    Machine-readable OpenAPI 3.1 spec
  • POST/api/v1/auth/signup
    Register a new user
  • POST/api/v1/auth/signin
    Exchange credentials for a session
  • POST/api/v1/auth/signout
    Revoke current session
  • GET/api/v1/auth/me
    Fetch the authenticated user
  • GET/api/v1/assets
    List assets (filter, paginate, search)
  • POST/api/v1/assets
    Create a new asset
  • GET/api/v1/assets/{id}
    Fetch a single asset
  • PUT/api/v1/assets/{id}
    Update an asset (owner only)
  • DELETE/api/v1/assets/{id}
    Delete an asset (owner only)
  • GET/api/v1/vaults
    List vaults (filter, paginate, search)
  • POST/api/v1/vaults
    Create a new vault
  • GET/api/v1/vaults/{id}
    Fetch a single vault
  • PUT/api/v1/vaults/{id}
    Update a vault (owner only)
  • DELETE/api/v1/vaults/{id}
    Delete a vault (owner only)
  • GET/api/v1/certificates
    List certificates (public verification)
  • POST/api/v1/certificates
    Create a certificate (asset owner only)
  • GET/api/v1/certificates/{id}
    Fetch a single certificate
  • GET/api/v1/certificates/number/{n}
    Look up certificate by number
  • PUT/api/v1/certificates/{id}
    Update a certificate (asset owner only)
  • DELETE/api/v1/certificates/{id}
    Delete a certificate (asset owner only)
  • GET/api/v1/verify/certificate/{n}
    Public verify by certificate number
  • GET/api/v1/verify/nfc/{uid}
    Public verify by NFC UID
  • GET/api/v1/verify/qr/{id}
    Public verify by QR / asset id
  • GET/api/v1/verification-logs
    Verification audit log (owner-scoped)
  • GET/api/v1/verification-logs/{id}
    Fetch a single verification log
  • GET/api/v1/organizations
    List organizations
  • POST/api/v1/organizations
    Create an organization
  • GET/api/v1/organizations/{id}
    Fetch an organization
  • PUT/api/v1/organizations/{id}
    Update an organization
  • DELETE/api/v1/organizations/{id}
    Delete an organization
  • GET/api/v1/user-roles
    List role assignments (RLS-scoped)
  • POST/api/v1/user-roles
    Assign a role
  • PUT/api/v1/user-roles/{id}
    Update a role assignment
  • DELETE/api/v1/user-roles/{id}
    Remove a role assignment
  • GET/api/v1/listings
    List marketplace listings
  • POST/api/v1/listings
    Create a listing (verified assets only)
  • GET/api/v1/listings/{id}
    Fetch a marketplace listing
  • PUT/api/v1/listings/{id}
    Update a listing (seller or org admin)
  • DELETE/api/v1/listings/{id}
    Delete a listing (seller or org admin)
  • GET/api/v1/orders
    List orders (buyer, seller, or org admin scope)
  • POST/api/v1/orders
    Create an order against an active listing
  • GET/api/v1/orders/{id}
    Fetch a single order
  • PUT/api/v1/orders/{id}
    Update fulfillment / payment state
  • GET/api/v1/payments
    List payments (buyer, seller, or org admin scope)
  • POST/api/v1/payments
    Record a payment against an order (no live charge yet)
  • GET/api/v1/payments/{id}
    Fetch a single payment
  • PUT/api/v1/payments/{id}
    Update payment status / provider metadata

Connected frontends

  • paidideas.com
  • nfcauthenticators.com
  • nextfrontiercards.com
  • meggaverse.io
  • maxxmybrand.com
  • Future mobile apps

Next phases

Assets · Vaults · Certificates · NFC Verification · Marketplace · Users · Organizations