Twitter V3 API call Get funding instruments return Paused = null value

[Salashah]

We noticed since we started using v3 of funding instrument API. We start seeing the attribute “paused” has null value where we get false value using v2. The documentation link below mentioned that “paused” attribute has 2 possible values (true and false). Is this a bug which is to be fixed ? Below we put an example responses (v2 and v3) we get against the same account id (18ce54jukpw).

https://developer.twitter.com/en/docs/ads/campaign-management/api-reference/funding-instruments

Twitter API V2
[
{
…
“AccountId”: “18ce54jukpw”,
“Currency”: “USD”,
“type”: “PARTNER_MANAGED”,
“ReasonsNotAbleToFund”: [],
“created_at”: “2017-08-16T11:07:41Z”,
“start_time”: “2017-08-16T11:07:41Z”,
“end_time”: null,
“deleted”: false,
"paused": false,
“able_to_fund”: true,
“Id”: “p3moq”,
…
“updated_at”: “2018-04-06T03:41:06Z”,
“cancelled”: false,

]

Twitter API V3
[
{
…
“AccountId”: “18ce54jukpw”,
“Currency”: “USD”,
“type”: “PARTNER_MANAGED”,
“ReasonsNotAbleToFund”: [],
“created_at”: “2017-08-16T11:07:41Z”,
“start_time”: “2017-08-16T11:07:41Z”,
“end_time”: null,
“deleted”: false,
"paused": null,
“able_to_fund”: true,
…
“updated_at”: “2018-04-06T03:41:06Z”,
“cancelled”: null,
]

[majoritasdev]

Hi @Salashah! The paused response attribute for funding instruments has been removed in version 3. Please see all the changes made in version 3 at https://developer.twitter.com/en/docs/ads/general/overview/versions#v3. And under “Other changes” --> “Removed”, you can read:

The paused response attribute is no longer returned for funding instruments. Instead, look to the entity_status response attribute to determine whether or not a funding instrument is paused. In addition, because paused and cancelled correspond to the same value, cancelled is no longer returned in the response, either.

Cheers!

[Salashah]

Thank you for your quick reply.

entity_status there is no type mentioned in documents, I can see entity_status = ACTIVE,
Can you provide more details about entity_status attributes?

[majoritasdev]

What do you mean by “type”? entity_status can be ACTIVE or PAUSED, or, for campaigns, DRAFT. I don’t know if it can have any other values, but I don’t think so. It doesn’t appear on the Enumerations page like it should. You could search in the page at the link above, for entity_status and see what other information there is about it.

@juanshishido, @imit8me: on the Enumerations page, for Funding Instruments there should be the values for entity_status as well. Maybe you could pass this along to the docs team. Thank you!

[imit8me]

Thanks for the help @majoritasdev! You’re correct in that, only the entity_status of ACTIVE and PAUSED apply to Funding Instruments.

We’ll add it to our backlog to update the Enumerations page.

Thanks!

[majoritasdev]

Thank you, @imit8me!