Update Checkin

Public Beta Feature

This documentation covers a feature currently in Public Beta. Access is available to anyone interested in building personalized experiences for their end-users.

This feature is subject to the Personalization API (Self-Service) Public Beta End user License Agreement.

Parameters

checkin_id
Type: string
Required

v
Type: string
Required
The API version date as documented here; e.g. 20231010

shout
Type: string
A message about your check-in. The maximum length of this field is 200 characters.

API Response

200

Object: Updates a check-in with a 200 status code response.

meta
Object: Metadata object for a successful update of a check-in.

• code
  Type: integer
  Defaults to 0
  Status code for successful update of a check-in, contained within the metadata object of the response.
• requestId
  Type: string
  Unique identifier for the API request associated with updating a check-in response.

notifications
Array of objects: Response object containing notification information for a successful update to a check-in.

• item , Type: object
  Array containing notification objects for the updated check-in.
  • type
    Type: string
    The notification type for a specific check-in update.

response
Object: The response object for updating a check-in with a 200 status code.

• checkin
  Object containing information about the updated check-in associated with the given checkin_id.

Sample cURL Request

curl --request POST \
     --url https://api.foursquare.com/v2/checkins/checkin_id/update \
     --header 'accept: application/json'

Example Response

{
  "meta": {
    "code": 200,
    "requestId": "642216f6dca15c004ac90c64"
  },
  "notifications": [
    {
      "type": "notificationTray",
      "item": {
        "unreadCount": 0
      }
    },
    {
      "type": "unconfirmed",
      "item": {
        "unreadCount": 0
      }
    }
  ],
  "response": {
    "checkin": {
      "id": "59b97e6cf79faa0d5e23abeb",
      "createdAt": 1505328748,
      "type": "checkin",
      "private": true,
      "visibility": "private",
      "entities": [],
      "shout": "Monday monday!",
      "timeZoneOffset": -240,
      "venue": {
        "id": "4f0de7267bebfc146005dcc0",
        "name": "Mattlantis 🐳"
      },
      "isMayor": false,
      "posts": {
        "count": 0,
        "textCount": 0
      },
      "comments": {
        "count": 0
      },
      "source": {
        "name": "Swarm for iOS",
        "url": "https://www.swarmapp.com"
      }
    }
  }
}