Activities

The Activities endpoints represents the core interactions within the mio.ID platform. These interactions, such as requests, sharings, or exchanges, enable members from the mio.ID Community to securely share their data with one another.

GET List of activities Fetches a list of all activities related to your business account, including both sent and received interactions.

GET Activity details Retrieves detailed information about a specific activity using its unique identifier.

Business' activities

get

Lists all Business' activities sent or received

Authorizations

Bearer Auth

AuthorizationstringRequired

Enter JWT token

Query parameters

limitnumberOptional

Max number of items to fetch

Default: 35

pagenumberOptionalDefault: 1

idstringOptional

Activity ID

Example: 3f611e21-496b-42a8-90c5-ea3980dc8b90

cifcodestringOptional

Profile ID

Example: cd157309-24c4-480a-87de-77f984c5c666

entitystring[]Optional

Individual/Business ID

Example: cb03ecb5-b83b-4a8a-adc2-1c34dabd86f5

fromstringOptional

Range initial date. Must be before or equal to To filter. yyyy-MM-dd format

Example: 2010-12-01

tostringOptional

Range final date. If From specified, this will be current time by default. yyyy-MM-dd format

Example: 2010-12-31

Header parameters

x-api-keystringRequired

Your credential's unique identifier key

x-pvt-timezonestringOptional

Your timezone

Responses

200

Returns all Business' activities

application/json

has_nextbooleanRequired

Indicates whether next pagination is available

Example: true

400

In case of any exception/failure, status will be 4XX-500 and response payload will contain its unique code and a descriptive message

application/json

get

/business/v1/activities

HTTPcURLJavaScriptPython

GET /business/v1/activities HTTP/1.1
Host: api.mio.id
Authorization: Bearer YOUR_SECRET_TOKEN
x-api-key: text
Accept: */*

{
  "has_next": true,
  "data": [
    {
      "id": "557e4976-0b9f-4912-bc4c-91ab8afa4898",
      "type": "AT_001",
      "in_out_bound": "IN",
      "entity": {
        "id": "4e23c659-306a-46fc-8333-7699b9943475",
        "name": "John Doe",
        "cifcode": "0b812663-e6b2-421a-9a59-0f9579378221",
        "type": "INDIVIDUAL",
        "avatar": "https://cdn.mio.id/my-avatar",
        "score": 650,
        "scoring_level": "GOOD",
        "social_media": [
          {
            "media": "X",
            "url": "https://x.com/mioid"
          }
        ],
        "created_at": 1,
        "unregistered": true
      },
      "status": "ACCEPTED",
      "time_zone": "America/New_York",
      "created_at": 1704085500000
    }
  ]
}

Activity's details, containing accepted requirements

get

Activity's details, containing accepted requirements

Authorizations

Bearer Auth

AuthorizationstringRequired

Enter JWT token

Path parameters

activitystringRequired

Activity ID

Example: 484472b4-ab92-4073-be1f-b9a48676104c

Header parameters

x-api-keystringRequired

Your credential's unique identifier key

x-pvt-timezonestringOptional

Your timezone

Responses

200

Returns activity's details, containing accepted requirements

application/json

idstringRequired

Activity ID

Example: ffe314b3-0c0a-4a5a-9877-e7b8c560f73f

typestring · enumRequired

Activity type

Example: AT_001Possible values:

type_namestringRequired

Activity type name

Example: Request

in_out_boundstring · enumRequired

Indicates if this Activity has been sent by you or you received this from another member

Example: INPossible values:

descriptionstringRequired

Message to deliver to your activity's receptor

Example: I'm requesting for your phone number

statusstring · enumRequired

Activity status

Example: ACCEPTEDPossible values:

notification_messagestringRequired

Message to deliver to your activity's emitter

Example: I'm sharing with you my phone number

time_zonestringRequired

Timezone

Example: America/New_York

valid_untilnumberRequired

Datetime when Activity will be CANCELED due to inactivity

Example: 1704085500000

attended_atnumberRequired

Datetime when counterpart accepted/declined this Activity

Example: 1704085290000

completed_atnumberRequired

Datetime when Activity has been set as COMPLETED

Example: 1704085319000

expires_atnumberRequired

Datetime when shared resources will stop being available

Example: 1704689999000

created_atobjectRequired

Datetime when Activity has been created

Example: 1704085200000

updated_atobjectRequiredExample: 1704085200000

400

In case of any exception/failure, status will be 4XX-500 and response payload will contain its unique code and a descriptive message

application/json

get

/business/v1/activities/{activity}

HTTPcURLJavaScriptPython

GET /business/v1/activities/{activity} HTTP/1.1
Host: api.mio.id
Authorization: Bearer YOUR_SECRET_TOKEN
x-api-key: text
Accept: */*

{
  "id": "ffe314b3-0c0a-4a5a-9877-e7b8c560f73f",
  "entity": {
    "id": "4e23c659-306a-46fc-8333-7699b9943475",
    "name": "John Doe",
    "cifcode": "0b812663-e6b2-421a-9a59-0f9579378221",
    "type": "INDIVIDUAL",
    "avatar": "https://cdn.mio.id/my-avatar",
    "score": 650,
    "scoring_level": "GOOD",
    "social_media": [
      {
        "media": "X",
        "url": "https://x.com/mioid"
      }
    ],
    "created_at": 1,
    "unregistered": true
  },
  "type": "AT_001",
  "type_name": "Request",
  "in_out_bound": "IN",
  "requirements": [
    {
      "code": "RQ_002",
      "items": [
        {
          "code": "IDT_002"
        }
      ]
    }
  ],
  "accepted_requirements": [
    {
      "code": "RQ_002",
      "type": "RTP_002",
      "category": "RQC_001",
      "data": {
        "value": {}
      },
      "items": [
        {
          "code": "IDT_002",
          "type": "RTP_002",
          "data": {
            "value": {}
          }
        }
      ]
    }
  ],
  "declined_requirements": [
    {
      "code": "RQ_002",
      "items": [
        {
          "code": "IDT_002"
        }
      ]
    }
  ],
  "description": "I'm requesting for your phone number",
  "status": "ACCEPTED",
  "notification_message": "I'm sharing with you my phone number",
  "timeline": [
    {
      "status": "ACCEPTED",
      "date_time": "2026-05-14T18:44:30.855Z",
      "message": "I'm sharing my phone number",
      "http_request_id": "0e8db85b-e344-4965-a429-df1b9cf75539"
    }
  ],
  "time_zone": "America/New_York",
  "expires_in": {
    "time_unit": "HOURS",
    "amount": 1
  },
  "valid_until": 1704085500000,
  "attended_at": 1704085290000,
  "completed_at": 1704085319000,
  "expires_at": 1704689999000,
  "created_at": 1704085200000,
  "updated_at": 1704085200000
}