Slack Web API

/team.accessLogs

GET

/team.accessLogs

team

Gets the access logs for the current team.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://slack.com/api/team.accessLogs?token='

Response Example

200 - response

{
  "logins": [
    {
      "count": 1,
      "country": "US",
      "date_first": 1422922864,
      "date_last": 1422922864,
      "ip": "127.0.0.1",
      "isp": "BigCo ISP",
      "region": "CA",
      "user_agent": "SlackWeb Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2272.35 Safari/537.36",
      "user_id": "U45678",
      "username": "alice"
    },
    {
      "count": 1,
      "country": "US",
      "date_first": 1422922493,
      "date_last": 1422922493,
      "ip": "127.0.0.1",
      "isp": "BigCo ISP",
      "region": "CA",
      "user_agent": "SlackWeb Mozilla/5.0 (iPhone; CPU iPhone OS 8_1_3 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) Version/8.0 Mobile/12B466 Safari/600.1.4",
      "user_id": "U12345",
      "username": "white_rabbit"
    }
  ],
  "ok": true,
  "paging": {
    "count": 100,
    "page": 1,
    "pages": 1,
    "total": 2
  }
}

Request

Query Params

token

string

required

Authentication token. Requires scope: admin

before

string

optional

End of time range of logs to include in results (inclusive).

count

string

optional

page

string

optional

Responses

🟢200This response demonstrates pagination and two access log entries.

application/json

Body

Schema for successful response from team.accessLogs method

logins

array [object {10}]

required

>= 1 items

count

integer

required

country

string | null

required

date_first

integer

required

date_last

integer

required

string | null

required

isp

string | null

required

region

string | null

required

user_agent

string

required

user_id

string

required

Match pattern:

^[UW][A-Z0-9]{2,}$

username

string

required

enum<boolean>

required

Allowed value:

true

paging

object (paging object)

required

count

integer

optional

page

integer

required

pages

integer

optional

per_page

integer

optional

spill

integer

optional

total

integer

required

🔴500A workspace must be on a paid plan to use this method, otherwise the `paid_only` error is thrown:

Modified at 2023-08-15 05:39:46

/stars.remove

/team.billableInfo