friendica/doc/API-Entities.md

Friendica API entities

• Home
  • Using the APIs

Activities

Attribute	Type	Nullable
like	List of Contacts	No
dislike	List of Contacts	No
attendyes	List of Contacts	No
attendno	List of Contacts	No
attendmaybe	List of Contacts	No

Attachment

Attribute	Type	Nullable
url	String (URL)	No
mimetype	String	No
size	Integer (bytes)	No

Contact

Attribute	Type	Nullable
id	Integer	No
id_str	String	No
name	String	No
screen_name	String	No
location	String	No
description	String	No
profile_image_url	String (URL)	No
profile_image_url_https	String (URL)	No
profile_image_url_profile_size	String (URL)	No
profile_image_url_large	String (URL)	No
url	String (URL)	No
protected	Boolean	No
followers_count	Integer	No
friends_count	Integer	No
listed_count	Integer	No
favourites_count	Integer	No
statuses_count	Integer	No
created_at	String (Date) Ex: Wed May 23 06:01:13 +0000 2007	No
utc_offset	Integer	No
time_zone	String	No
geo_enabled	Boolean	No
verified	Boolean	No
lang	String	No
contributors_enabled	Boolean	No
is_translator	Boolean	No
is_translation_enabled	Boolean	No
following	Boolean	No
follow_request_sent	Boolean	No
statusnet_blocking	Boolean	No
notifications	Boolean	No
statusnet_profile_url	String (URL)	No
uid	Integer	No
cid	Integer	No
pid	Integer	No
self	Integer	No
network	String	No

Entities

Attribute	Type	Nullable
hashtags	List of Hashtags	No
symbols	List of Symbols	No
urls	List of URLs	No
user_mentions	List of User mentions	No
media	List of Medias	No

Event

Attribute	Type	Description
id	Integer
uid	Integer	Owner User Id
cid	Integer	Target Contact Id
uri	String	Item unique URI string
name	String (Plaintext)	Title
desc	String (HTML)	Description
start_time	String (UTC YYYY-MM-DD HH:II:SS))
end_time	String (UTC YYYY-MM-DD HH:II:SS))	Optional (null date is 0001-01-01 00:00:00
type	String (event or birthday)
nofinish	Boolean	Ongoing event
place	String	Optional. Location.
ignore	Boolean	???
allow_cid	String (angle-brackets escaped integers)	Optional. List of allowed contact ids
allow_gid	String (angle-brackets escaped integers)	Optional. List of allowed group ids
deny_cid	String (angle-brackets escaped integers)	Optional. List of disallowed contact ids
deny_gid	String (angle-brackets escaped integers)	Optional. List of disallowed group ids

Hashtag

Unused

Item

Attribute	Type	Nullable
text	String (Plaintext)	No
truncated	Boolean	No
created_at	String (Date) Ex: Wed May 23 06:01:13 +0000 2007	No
in_reply_to_status_id	Integer	No
in_reply_to_status_id_str	String	No
source	String	No
id	Integer	No
id_str	String	No
in_reply_to_user_id	Integer	No
in_reply_to_user_id_str	String	No
in_reply_to_screen_name	String	No
geo	String	Yes
favorited	Boolean	No
user	Contact	No
friendica_author	Contact	No
friendica_owner	Contact	No
friendica_private	Boolean	No
statusnet_html	String (HTML)	No
statusnet_conversation_id	Integer	No
external_url	String (URL)	No
friendica_activities	Activities	No
friendica_title	String (Plaintext)	No
friendica_html	String (HTML)	No
attachments	List of Attachments	Yes
entities	Entities	Yes

Media

Identical to the Twitter Media Object.

Attribute	Type	Nullable
id	Integer	No
id_str	String	No
indices	List of Integer	No
media_url	String (URL)	No
media_url_https	String (URL)	No
url	String (URL)	No
display_url	String (URL)	No
expanded_url	String (URL)	No
ext_alt_text	String	No
type	String	No
sizes	Sizes	No

Notification

Attribute	Type	Description
id	Integer
hash	String
type	Integer	1: Inbound follow request 2: Outbound follow request confirmation 4: Wall-to-wall post 8: Reply 16: Private message 32: Friend suggestion 64: Unused 128: Mention 256: Tag added to a post 512: Poke (Obsolete) 1024: New post 16384: System email 32768: System event
name	String	Full name of the contact subject
url	String (URL)	Profile page URL of the contact subject
photo	String (URL)	Profile photo URL of the contact subject
date	String (Date)	YYYY-MM-DD hh:mm:ss local server time
msg	String (BBCode)
uid	Integer	Owner User Id
link	String (URL)	Notification URL
iid	Integer	Item Id
parent	Integer	Parent Item Id
seen	Integer (Boolean)	Whether the notification was read or not.
verb	String (URL)	[Activity Streams](http://activitystrea.ms) Verb URL
seen	Integer (Boolean)	Whether the notification was read or not.
otype	Enum	Subject type (`item`, `intro` or `mail`)
name_cache	String (HTML)	Full name of the contact subject
msg_cache	String (Plaintext)	Plaintext version of the notification text with a placeholder (`{0}`) for the subject contact's name.
timestamp	Integer	Unix timestamp
date_rel	String	Time since the note was posted, eg "1 hour ago"
msg_html	String (HTML)
msg_plain	String (Plaintext)

Photo

Attribute	Type	Description
id	String	Resource ID (32 hex chars)
media-id	String (Integer)	ID used for attaching images to a Mastodon Post Status
created	String (Date)	Format YYYY-MM-DD HH:MM:SS
edited	String (Date)	Format YYYY-MM-DD HH:MM:SS
title	String
desc	String (Plaintext)	Picture caption
album	String	Album name
filename	String	Original image filename
type	String	MIME Type
height	Integer	Image height in pixels
width	Integer	Image width in pixels
profile	Integer	1 if it is a profile photo
allow_cid	String (ACL)	List of contact ids wrapped in angle brackets allowed to access the photo.
allow_gid	String (ACL)	List of contact group ids wrapped in angle brackets allowed to access the photo.
deny_cid	String (ACL)	List of contact ids wrapped in angle brackets forbidden to access the photo.
deny_gid	String (ACL)	List of contact group ids wrapped in angle brackets forbidden to access the photo.
link	Array of Strings (URL)	URLs to the different scales indexed by scale number if no specific scale was requested. Mutually exclusive with data datasize.
scales	Array of Photo Scales	List of the various resized versions of the Photo
datasize	Integer	Picture size in bytes if a single scale was requested. Mutually exclusive with link.
data	String	Base64-encoded image data if a single scale was requested. Mutually exclusive with link.
friendica_activities	Activities
friendica_comments	List of Items
rights_mismatch	Boolean	True if the ACL differs between the picture and the associated item.

Photo Scale

Attribute	Type	Nullable
id	String (Integer)	Row ID of this photo scale
scale	Integer	Scale number
link	String (URL)	URL to this scale's image
height	Integer	Image height in pixels
width	Integer	Image width in pixels
size	Integer	Image size in bytes

Photo List Item

Attribute	Type	Description
id	String	Resource ID (32 hex chars)
album	String	Album name
filename	String	Original image filename
type	String	MIME Type
created	String (Date)	Format YYYY-MM-DD HH:MM:SS
edited	String (Date)	Format YYYY-MM-DD HH:MM:SS
desc	String (Plaintext)	Picture caption
thumb	String (URL)	URL of the smallest scale version of the picture.

Photo Album

Attribute	Type	Description
name	String	The name of the photo album
created	String (Date)	The creation date of the album. Format YYYY-MM-DD HH:MM:SS
count	Integer	The number of images in the album

Private message

Attribute	Type	Description
id	Integer
sender_id	Integer	Sender Contact Id
text	String	Can be HTML or plaintext depending on the API call parameter `getText`.
recipient_id	Integer	Recipient Contact Id
created_at	String (Date)	Ex: Wed May 23 06:01:13 +0000 2007
sender_screen_name	String
recipient_screen_name	String
sender	Contact
recipient	Contact
title	String	Empty if the API call parameter `getText` is empty or absent.
friendica_seen	Integer (Boolean)	Whether the private message has been read or not.
friendica_parent_uri	String

Profile

Attribute	Type	Description
profile_id	Integer
profile_name	String
is_default	Boolean
hide_friends	Boolean	Whether the user chose to hide their contact list on their profile.
profile_photo	String (URL)	Largest size profile picture URL.
profile_thumb	String (URL)	Smallest size profile picture URL.
publish	Boolean	Whether the user chose to publish their profile in the local directory.
net_publish	Boolean	Whether the user chose to publish their profile in the global directory.
description	String
date_of_birth	String
address	String
city	String
region	String
postal_code	String
country	String
public_keywords	String	Comma-separated list of words meant to be displayed as hashtags.
private_keywords	String	Comma-separated list of words meant to be used for search only.
homepage	String (URL)

Size

Attribute	Type	Nullable

Attribute	Type	Nullable
w	Integer	No
h	Integer	No
resize	Enum (fit, crop)	Yes

Sizes

Attribute	Type	Nullable
medium	Size	No
large	Size	Yes
thumb	Size	Yes
small	Size	Yes

Symbol

Unused

URL

Attribute	Type	Nullable
url	String (URL)	No
expanded_url	String (URL)	No
display_url	String (URL)	No
indices	List of Integer	No

User Mention

Unused