Getting a tag

Contents

• Overview
• Version-specific information
• Permissions and Authentication
• Headers
• HTTP Parameters
• Sample request
• Sample response
• Possible error responses

Overview

• Call name: get-tag
• Endpoint URL: https://api0.spaaza.com/auth/get-tag
• Request methods: GET
• Response Content-Type: application/json
• Auth required: yes

This endpoint retrieves a tag by its ID.

Version-specific information

The following version-specific changes apply to this endpoint. See the versioning page for more details.

Permissions and Authentication

This API call requires admin authentication:

• The performing user must be logged in and have READ access to the chain to which the tag is connected
• User and privileged authentication methods are not permitted for this endpoint

Headers

Standard headers are used for this endpoint. No special headers are required.

HTTP Parameters

The following HTTP parameters can be passed to the API:

Sample request

GET /auth/get-tag?id=1 HTTP/1.1

Sample response

{
    "result": {
        "code": 1,
        "status": "ok"
    },
    "results": {
        "tag": {
            "active": true,
            "chain": {
                "email_address": "info@foo.com",
                "id": 1,
                "name": "FOO Chain, inc.",
                "phone_number": "01 1234 4321"
            },
            "created_date": "2025-01-23T13:53:39+00:00",
            "deleted": false,
            "id": 1,
            "last_modified_date": "2025-01-23T13:53:39+00:00",
            "model_class": "user",
            "value": "baby_club_feb_2025"
        },
        "result_type": "get-tag"
    }
}

Possible error responses

The following represents a list of possible error responses for the get-tag endpoint: