GET Users & notifications

Get User Details

This will return all the information about the user.

GET /api/v3/{appid}/user/users/{userid}

This method requires authentication.

This will return all the information about the user.

Request

Parameters

Values in the path and query string.

appid path

string TalkLabs ID required

The application the user belongs to.

Example: your-app-id

userid path

string customer-defined required

The app specific user ID to look up.

Example: u-8842

Response

Status codes

Every JSON response uses the API result envelope.

200 OK: success data is the AppUser. ApiResult

400 BadRequest: the userid parameter is missing or invalid. ApiResult

403 Forbidden: request is not authorized with a valid token, or the token does not match this appid. ApiResult

404 NotFound: no user exists for the given userid. ApiResult

500 Internal Server Error ApiResult

curl --request GET \
  --url "https://api.sportstalk247.com/api/v3/${APP_ID}/user/users/${USER_ID}" \
  --header "Accept: application/json" \
  --header "x-api-token: ${TALKLABS_API_TOKEN}"

const appId = process.env.TALKLABS_APP_ID;
const userid = 'u-8842';

const response = await fetch(
  `https://api.sportstalk247.com/api/v3/${appId}/user/users/${userid}`,
{
  method: 'GET',
  headers: {
    Accept: 'application/json',
    'x-api-token': process.env.TALKLABS_API_TOKEN,
  },
});

const result = await response.json();

import json
import os
import requests

app_id = os.environ["TALKLABS_APP_ID"]
userid = "u-8842"

response = requests.get(
    f"https://api.sportstalk247.com/api/v3/{app_id}/user/users/{userid}",
    headers={
        "Accept": "application/json",
        "x-api-token": os.environ["TALKLABS_API_TOKEN"],
    },
)
response.raise_for_status()
result = response.json()

Environment variables TALKLABS_APP_ID TALKLABS_API_TOKEN

Response