Account Management - Get Profiles
Retrieves the entity's profile.
POST https://titleId.playfabapi.com/Profile/GetProfilesRequest Header
| Name | Required | Type | Description |
|---|---|---|---|
| X-EntityToken | True |
string |
This API requires an Entity Session Token, available from the Entity GetEntityToken method. |
Request Body
| Name | Required | Type | Description |
|---|---|---|---|
| Entities | True |
Entity keys of the profiles to load. Must be between 1 and 25 |
|
| CustomTags |
object |
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). |
|
| DataAsObject |
boolean |
Determines whether the objects will be returned as an escaped JSON string or as a un-escaped JSON object. Default is JSON string. |
Responses
| Name | Type | Description |
|---|---|---|
| 200 OK | ||
| 400 Bad Request |
This is the outer wrapper for all responses with errors |
Security
X-EntityToken
This API requires an Entity Session Token, available from the Entity GetEntityToken method.
Type:
apiKey
In:
header
Definitions
| Name | Description |
|---|---|
|
Api |
The basic wrapper around every failed API response |
|
Effect |
|
|
Entity |
An entity object and its associated meta data. |
|
Entity |
Combined entity type and ID structure which uniquely identifies a single entity. |
|
Entity |
|
|
Entity |
|
|
Entity |
|
|
Entity |
An entity file's meta data. To get a download URL call File/GetFiles API. |
|
Entity |
|
|
Get |
Given a set of entity types and entity identifiers will retrieve all readable profiles properties for the caller. Profiles that the caller is not allowed to read will silently not be included in the results. |
|
Get |
ApiErrorWrapper
The basic wrapper around every failed API response
| Name | Type | Description |
|---|---|---|
| code |
integer |
Numerical HTTP code |
| error |
string |
Playfab error code |
| errorCode |
integer |
Numerical PlayFab error code |
| errorDetails |
object |
Detailed description of individual issues with the request object |
| errorMessage |
string |
Description for the PlayFab errorCode |
| status |
string |
String HTTP code |
EffectType
| Name | Type | Description |
|---|---|---|
| Allow |
string |
|
| Deny |
string |
EntityDataObject
An entity object and its associated meta data.
| Name | Type | Description |
|---|---|---|
| DataObject |
object |
Un-escaped JSON object, if DataAsObject is true. |
| EscapedDataObject |
string |
Escaped string JSON body of the object, if DataAsObject is default or false. |
| ObjectName |
string |
Name of this object. |
EntityKey
Combined entity type and ID structure which uniquely identifies a single entity.
| Name | Type | Description |
|---|---|---|
| Id |
string |
Unique ID of the entity. |
| Type |
string |
Entity type. See https://docs.microsoft.com/gaming/playfab/features/data/entities/available-built-in-entity-types |
EntityLineage
| Name | Type | Description |
|---|---|---|
| CharacterId |
string |
The Character Id of the associated entity. |
| GroupId |
string |
The Group Id of the associated entity. |
| MasterPlayerAccountId |
string |
The Master Player Account Id of the associated entity. |
| NamespaceId |
string |
The Namespace Id of the associated entity. |
| TitleId |
string |
The Title Id of the associated entity. |
| TitlePlayerAccountId |
string |
The Title Player Account Id of the associated entity. |
EntityPermissionStatement
| Name | Type | Description |
|---|---|---|
| Action |
string |
The action this statement effects. May be 'Read', 'Write' or '*' for both read and write. |
| Comment |
string |
A comment about the statement. Intended solely for bookkeeping and debugging. |
| Condition |
object |
Additional conditions to be applied for entity resources. |
| Effect |
The effect this statement will have. It may be either Allow or Deny |
|
| Principal |
object |
The principal this statement will effect. |
| Resource |
string |
The resource this statements effects. Similar to 'pfrn:data--title![Title ID]/Profile/*' |
EntityProfileBody
| Name | Type | Description |
|---|---|---|
| AvatarUrl |
string |
Avatar URL for the entity. |
| Created |
string |
The creation time of this profile in UTC. |
| DisplayName |
string |
The display name of the entity. This field may serve different purposes for different entity types. i.e.: for a title player account it could represent the display name of the player, whereas on a character it could be character's name. |
| Entity |
The entity id and type. |
|
| EntityChain |
string |
The chain of responsibility for this entity. Use Lineage. |
| ExperimentVariants |
string[] |
The experiment variants of this profile. |
| Files |
The files on this profile. |
|
| Language |
string |
The language on this profile. |
| Lineage |
The lineage of this profile. |
|
| Objects |
The objects on this profile. |
|
| Permissions |
The permissions that govern access to this entity profile and its properties. Only includes permissions set on this profile, not global statements from titles and namespaces. |
|
| Statistics |
The statistics on this profile. |
|
| VersionNumber |
number |
The version number of the profile in persistent storage at the time of the read. Used for optional optimistic concurrency during update. |
EntityProfileFileMetadata
An entity file's meta data. To get a download URL call File/GetFiles API.
| Name | Type | Description |
|---|---|---|
| Checksum |
string |
Checksum value for the file, can be used to check if the file on the server has changed. |
| FileName |
string |
Name of the file |
| LastModified |
string |
Last UTC time the file was modified |
| Size |
number |
Storage service's reported byte count |
EntityStatisticValue
| Name | Type | Description |
|---|---|---|
| Metadata |
string |
Metadata associated with the Statistic. |
| Name |
string |
Statistic name |
| Scores |
string[] |
Statistic scores |
| Version |
number |
Statistic version |
GetEntityProfilesRequest
Given a set of entity types and entity identifiers will retrieve all readable profiles properties for the caller. Profiles that the caller is not allowed to read will silently not be included in the results.
| Name | Type | Description |
|---|---|---|
| CustomTags |
object |
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). |
| DataAsObject |
boolean |
Determines whether the objects will be returned as an escaped JSON string or as a un-escaped JSON object. Default is JSON string. |
| Entities |
Entity keys of the profiles to load. Must be between 1 and 25 |
GetEntityProfilesResponse
| Name | Type | Description |
|---|---|---|
| Profiles |
Entity profiles |