Skip to main content

Get pending ID tags for onboarding

GET 
/id-tags/pending

Retrieves all ID tags with PENDING status that are awaiting user assignment during onboarding workflows.

Use Cases:

  • Display unassigned tags in onboarding dashboards
  • Bulk provisioning workflows (distribute cards before assignment)
  • Self-service tag claim interfaces
  • Admin review queues for new hardware
  • Track provisioning progress and completion

What are Pending Tags? Pending tags are credentials created without an assigned userId. Common scenarios:

  • Bulk Import: Pre-create tags for physical RFID cards before distribution
  • Self-Service: Users claim tags by scanning RFID cards in mobile app
  • Admin Review: Tags awaiting approval before activation
  • Inventory Management: Track unassigned hardware inventory

Response Characteristics:

  • All returned tags have status=PENDING
  • userId field is null for all results
  • organizationId may be set (org-level provisioning)
  • Tags sorted by creation date (newest first by default)
info

This endpoint is equivalent to GET /id-tags?status=PENDING but provides a dedicated path for onboarding workflows.

tip

For self-service tag claiming, users can scan their RFID card to find the matching pending tag, then call activate endpoint to assign it to their account.

note

Pending tags cannot authorize charging sessions until activated. Use activate endpoint or update userId + status=ACTIVE to enable charging.

Request​

Responses​

Standard structure for paginated API responses